@openzeppelin/upgrades-core 1.46.0 → 1.47.0

package/dist/utils/struct-member-docs.d.ts

@@ -0,0 +1,52 @@
+import { StructDefinition } from 'solidity-ast';
+import { SolcInput, SolcOutput } from '../solc-api';
+import { SrcDecoder } from '../src-decoder';
+/**
+ * Resolves the NatSpec documentation of the members of a struct, keyed by member name. Members without documentation
+ * are not included. Returns undefined if the documentation of the struct's members is not available.
+ */
+export type StructDocsResolver = (structDef: StructDefinition) => Map<string, string> | undefined;
+/**
+ * Thrown when the source text of a struct does not have the shape implied by its AST, so that the documentation of its
+ * members cannot be located. This happens with syntax that the scanner does not know about.
+ */
+export declare class UnexpectedStructSourceError extends Error {
+    readonly position: number;
+    constructor(message: string, position: number);
+}
+/**
+ * Builds a resolver for the member documentation of the structs in a compilation.
+ *
+ * Solidity does not include the NatSpec of struct members in its AST, so it is read from the source text in the
+ * compiler input, between the source offsets of the members. The struct given to the resolver may come from the
+ * namespaced compilation of the same sources, whose source text and AST ids differ from the original, so it is first
+ * mapped to the original definition by source id and canonical name, which are the same in both compilations.
+ *
+ * @param solcInput The compiler input, or undefined if it is not available, in which case no documentation is resolved.
+ * @param solcOutput The compiler output of the original compilation.
+ * @param decodeSrc Source decoder for the original source code.
+ * @returns The resolver, which throws an UpgradesError if the member documentation of a struct that contains rename or
+ *   retype annotations cannot be read, and an Error if the struct is not part of the original compilation.
+ */
+export declare function makeStructDocsResolver(solcInput: SolcInput | undefined, solcOutput: SolcOutput, decodeSrc: SrcDecoder): StructDocsResolver;
+/**
+ * Reads the NatSpec documentation of the members of a struct from the source text of its definition, located with the
+ * source offsets in the AST, which are byte offsets into the UTF-8 encoded source. The result is keyed by member
+ * name, and members without documentation are not included.
+ *
+ * A member is documented like a state variable preceded by the same comments would be: its documentation is the last
+ * `/**` block or run of consecutive `///` lines between the end of the previous member and the start of its
+ * declaration, with the comment markers removed as in `getDocumentationBefore`. Comments in the struct header, inside
+ * a member's declaration, between a member's name and its `;`, or after the last member document nothing.
+ *
+ * @throws UnexpectedStructSourceError if the source text of the struct does not have the shape implied by its AST.
+ */
+export declare function getStructMemberDocumentation(structDef: StructDefinition, source: Buffer): Map<string, string>;
+/**
+ * Returns the documentation that solc attaches to a declaration starting at byte `end` of the source when the previous
+ * token ends at byte `start`, or undefined if there is none. The bytes in between may only be whitespace and comments.
+ *
+ * @throws UnexpectedStructSourceError if there is anything else between `start` and `end`.
+ */
+export declare function getDocumentationBefore(source: Buffer, start: number, end: number): string | undefined;
+//# sourceMappingURL=struct-member-docs.d.ts.map

package/dist/utils/struct-member-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct-member-docs.d.ts","sourceRoot":"","sources":["../../src/utils/struct-member-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,gBAAgB,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;AAElG;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IAGlD,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBADzB,OAAO,EAAE,MAAM,EACN,QAAQ,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,UAAU,GACpB,kBAAkB,CA8DpB;AAwBD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAuB7G;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrG"}

package/dist/utils/struct-member-docs.js

@@ -0,0 +1,264 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnexpectedStructSourceError = void 0;
+exports.makeStructDocsResolver = makeStructDocsResolver;
+exports.getStructMemberDocumentation = getStructMemberDocumentation;
+exports.getDocumentationBefore = getDocumentationBefore;
+const utils_1 = require("solidity-ast/utils");
+const error_1 = require("../error");
+const debug_1 = __importDefault(require("./debug"));
+/**
+ * Thrown when the source text of a struct does not have the shape implied by its AST, so that the documentation of its
+ * members cannot be located. This happens with syntax that the scanner does not know about.
+ */
+class UnexpectedStructSourceError extends Error {
+    constructor(message, position) {
+        super(`${message} at byte ${position}`);
+        this.position = position;
+    }
+}
+exports.UnexpectedStructSourceError = UnexpectedStructSourceError;
+/**
+ * Builds a resolver for the member documentation of the structs in a compilation.
+ *
+ * Solidity does not include the NatSpec of struct members in its AST, so it is read from the source text in the
+ * compiler input, between the source offsets of the members. The struct given to the resolver may come from the
+ * namespaced compilation of the same sources, whose source text and AST ids differ from the original, so it is first
+ * mapped to the original definition by source id and canonical name, which are the same in both compilations.
+ *
+ * @param solcInput The compiler input, or undefined if it is not available, in which case no documentation is resolved.
+ * @param solcOutput The compiler output of the original compilation.
+ * @param decodeSrc Source decoder for the original source code.
+ * @returns The resolver, which throws an UpgradesError if the member documentation of a struct that contains rename or
+ *   retype annotations cannot be read, and an Error if the struct is not part of the original compilation.
+ */
+function makeStructDocsResolver(solcInput, solcOutput, decodeSrc) {
+    const sourcePaths = new Map();
+    const originalStructs = new Map();
+    for (const [sourcePath, { ast, id }] of Object.entries(solcOutput.sources)) {
+        sourcePaths.set(id, sourcePath);
+        for (const structDef of (0, utils_1.findAll)('StructDefinition', ast)) {
+            originalStructs.set(getStructKey(structDef), structDef);
+        }
+    }
+    const sources = new Map();
+    const docs = new Map();
+    function getSource(sourceId) {
+        if (!sources.has(sourceId)) {
+            const sourcePath = sourcePaths.get(sourceId);
+            const content = sourcePath === undefined ? undefined : solcInput?.sources[sourcePath]?.content;
+            if (content === undefined) {
+                (0, debug_1.default)(`Source content of ${sourcePath} is not available, annotations on its struct members are not read`);
+            }
+            sources.set(sourceId, content === undefined ? undefined : Buffer.from(content, 'utf8'));
+        }
+        return sources.get(sourceId);
+    }
+    function getDocs(structDef) {
+        const source = getSource(getSourceId(structDef));
+        if (source === undefined) {
+            return undefined;
+        }
+        try {
+            return getStructMemberDocumentation(structDef, source);
+        }
+        catch (e) {
+            if (!(e instanceof UnexpectedStructSourceError)) {
+                throw e;
+            }
+            const { start, end } = getPositions(structDef);
+            if (/@custom:oz-(renamed|retyped)-from/.test(source.toString('utf8', start, end))) {
+                throw new error_1.UpgradesError(`${decodeSrc(structDef)}: Could not read storage annotations on members of struct \`${structDef.canonicalName}\``, () => 'Please report this at https://zpl.in/upgrades/report and include the struct definition from your contract.');
+            }
+            (0, debug_1.default)(`${decodeSrc(structDef)}: Could not read member documentation of struct ${structDef.canonicalName}: ${e.message}`);
+            return undefined;
+        }
+    }
+    return structDef => {
+        const key = getStructKey(structDef);
+        const original = originalStructs.get(key);
+        if (original === undefined) {
+            throw new Error(`Broken invariant: struct ${structDef.canonicalName} not found in the original compilation`);
+        }
+        if (!docs.has(key)) {
+            docs.set(key, getDocs(original));
+        }
+        return docs.get(key);
+    };
+}
+function getStructKey(structDef) {
+    return `${getSourceId(structDef)}:${structDef.canonicalName}`;
+}
+function getSourceId(node) {
+    return Number(node.src.split(':')[2]);
+}
+function getPositions(node) {
+    const [start, length] = node.src.split(':').map(Number);
+    return { start, end: start + length };
+}
+// Byte values of the ASCII characters that delimit whitespace and comments. Any other byte, including the bytes of
+// multi-byte UTF-8 sequences, is only accepted inside a comment, where it is kept as it is.
+const TAB = 0x09;
+const LF = 0x0a;
+const CR = 0x0d;
+const SPACE = 0x20;
+const STAR = 0x2a; // *
+const SLASH = 0x2f; // /
+/**
+ * Reads the NatSpec documentation of the members of a struct from the source text of its definition, located with the
+ * source offsets in the AST, which are byte offsets into the UTF-8 encoded source. The result is keyed by member
+ * name, and members without documentation are not included.
+ *
+ * A member is documented like a state variable preceded by the same comments would be: its documentation is the last
+ * `/**` block or run of consecutive `///` lines between the end of the previous member and the start of its
+ * declaration, with the comment markers removed as in `getDocumentationBefore`. Comments in the struct header, inside
+ * a member's declaration, between a member's name and its `;`, or after the last member document nothing.
+ *
+ * @throws UnexpectedStructSourceError if the source text of the struct does not have the shape implied by its AST.
+ */
+function getStructMemberDocumentation(structDef, source) {
+    const docs = new Map();
+    const { start, end } = getPositions(structDef);
+    let pos = expectText(source, start, end, 'struct');
+    pos = expectText(source, skipTrivia(source, pos, end), end, structDef.name);
+    pos = expectText(source, skipTrivia(source, pos, end), end, '{');
+    for (const member of structDef.members) {
+        const memberPos = getPositions(member);
+        if (memberPos.start < pos || memberPos.end > end) {
+            throw new UnexpectedStructSourceError(`Member ${member.name} is outside the expected range`, memberPos.start);
+        }
+        const doc = getDocumentationBefore(source, pos, memberPos.start);
+        if (doc !== undefined) {
+            docs.set(member.name, doc);
+        }
+        // The source range of a member ends at its name and does not include the `;`
+        pos = expectText(source, skipTrivia(source, memberPos.end, end), end, ';');
+    }
+    pos = expectText(source, skipTrivia(source, pos, end), end, '}');
+    if (pos !== end) {
+        throw new UnexpectedStructSourceError('Expected the end of the struct', pos);
+    }
+    return docs;
+}
+/**
+ * Returns the documentation that solc attaches to a declaration starting at byte `end` of the source when the previous
+ * token ends at byte `start`, or undefined if there is none. The bytes in between may only be whitespace and comments.
+ *
+ * @throws UnexpectedStructSourceError if there is anything else between `start` and `end`.
+ */
+function getDocumentationBefore(source, start, end) {
+    const { pos, doc } = scanTrivia(source, start, end);
+    if (pos !== end) {
+        throw new UnexpectedStructSourceError('Unexpected text', pos);
+    }
+    return doc;
+}
+function skipTrivia(source, start, end) {
+    return scanTrivia(source, start, end).pos;
+}
+function expectText(source, pos, end, text) {
+    const next = pos + text.length;
+    if (next > end || !source.subarray(pos, next).equals(Buffer.from(text))) {
+        throw new UnexpectedStructSourceError(`Expected \`${text}\``, pos);
+    }
+    return next;
+}
+/**
+ * Scans the whitespace and comments starting at byte `start` of the source, stopping at `end` or at the first byte that
+ * is neither, and returns that position together with the text of the documentation found: the last `/**` block or
+ * run of consecutive `///` lines, or undefined if there is none or its text is empty.
+ *
+ * Whitespace is space, tab, CR and LF. A line comment is documentation if it starts with exactly three slashes, and a
+ * block comment if its `/**` is followed by neither `*` nor `/`. A run of `///` lines continues through the next `///`
+ * line only when exactly one line break and otherwise only spaces and tabs separate them: a blank line or any other
+ * comment, even on the same line, ends the run.
+ *
+ * @throws UnexpectedStructSourceError at a block comment that is not closed before `end`.
+ */
+function scanTrivia(source, start, end) {
+    const byteAt = (i) => (i < end ? source[i] : undefined);
+    let doc;
+    let runOpen = false;
+    let lineBreaks = 0;
+    let pos = start;
+    while (pos < end) {
+        const byte = source[pos];
+        if (byte === SPACE || byte === TAB) {
+            pos += 1;
+        }
+        else if (byte === LF || byte === CR) {
+            lineBreaks += 1;
+            pos += byte === CR && byteAt(pos + 1) === LF ? 2 : 1;
+        }
+        else if (byte === SLASH && byteAt(pos + 1) === SLASH) {
+            let lineEnd = pos + 2;
+            while (lineEnd < end && source[lineEnd] !== LF && source[lineEnd] !== CR) {
+                lineEnd += 1;
+            }
+            if (byteAt(pos + 2) === SLASH && byteAt(pos + 3) !== SLASH) {
+                const line = source.toString('utf8', pos + 3, lineEnd);
+                if (doc !== undefined && runOpen && lineBreaks === 1) {
+                    doc.lines.push(line);
+                }
+                else {
+                    doc = { block: false, lines: [line] };
+                }
+                runOpen = true;
+            }
+            else {
+                runOpen = false;
+            }
+            lineBreaks = 0;
+            pos = lineEnd;
+        }
+        else if (byte === SLASH && byteAt(pos + 1) === STAR) {
+            const close = source.indexOf('*/', pos + 2);
+            if (close < 0 || close + 2 > end) {
+                throw new UnexpectedStructSourceError('Unterminated block comment', pos);
+            }
+            if (byteAt(pos + 2) === STAR && byteAt(pos + 3) !== STAR && byteAt(pos + 3) !== SLASH) {
+                doc = { block: true, lines: source.toString('utf8', pos + 3, close).split(/\r\n|\r|\n/) };
+            }
+            runOpen = false;
+            lineBreaks = 0;
+            pos = close + 2;
+        }
+        else {
+            break;
+        }
+    }
+    return { pos, doc: doc === undefined ? undefined : getDocText(doc) };
+}
+/**
+ * Joins the lines of a documentation comment into the text that solc produces for the same comment on a state
+ * variable. Leading spaces and tabs are dropped from the first line and from every line of a block, then a single `*`
+ * at the start of a block line is dropped too, since it is a decoration. A block line that starts with `**` instead
+ * (counting the star that closes the comment for the last line) is kept whole and appended to the previous line
+ * without a line break. Lines that are left empty are dropped, and the rest are joined with `\n`.
+ *
+ * The text of a `///` run whose first line is blank starts with a line break in solc; here that line is dropped like
+ * any other blank line, which makes no difference to the annotations parsed from the text.
+ */
+function getDocText({ block, lines }) {
+    let text = '';
+    for (const [i, line] of lines.entries()) {
+        let content = i === 0 || block ? line.replace(/^[ \t]+/, '') : line;
+        let glued = false;
+        if (block && i > 0) {
+            if (content.startsWith('**') || (i === lines.length - 1 && content === '*')) {
+                glued = true;
+            }
+            else if (content.startsWith('*')) {
+                content = content.slice(1);
+            }
+        }
+        if (content.length > 0) {
+            text += text.length > 0 && !glued ? `\n${content}` : content;
+        }
+    }
+    return text.length > 0 ? text : undefined;
+}
+//# sourceMappingURL=struct-member-docs.js.map

package/dist/utils/struct-member-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct-member-docs.js","sourceRoot":"","sources":["../../src/utils/struct-member-docs.ts"],"names":[],"mappings":"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"}

package/dist/utils/struct-member-docs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=struct-member-docs.test.d.ts.map

package/dist/utils/struct-member-docs.test.d.ts.map

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