@sillsdev/docu-notion 0.12.0

package/dist/NotionImage-CaptionReading.spec.js

@@ -0,0 +1,233 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const images_1 = require("./images");
+const kPrimaryImageUrl = "https://s3.us-west-2.amazonaws.com/primaryImage.png?Blah=foo";
+/* didn't work?
+beforeAll(async () => {
+  console.log("before");
+  await initImageHandling("", "", []);
+  console.log("azfter");
+});
+*/
+/* eslint-disable @typescript-eslint/require-await */
+test("finds primary image url", () => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, images_1.initImageHandling)("", "", []);
+    const img = (0, images_1.parseImageBlock)(kImageBlockWithTwoLocalizedImages.image);
+    expect(img.primaryUrl).toBe(kPrimaryImageUrl);
+}));
+test("primary caption content after image links are removed", () => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, images_1.initImageHandling)("", "", []);
+    const img = (0, images_1.parseImageBlock)(kImageBlockWithTwoLocalizedImagesWrappedWithActualCaptionText.image);
+    // carriage returns seem to mess up the markdown, so should be removed
+    expect(img.caption).toBe("Caption before images. Caption after images.");
+}));
+test("gets localized image links", () => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, images_1.initImageHandling)("", "", []);
+    const img = (0, images_1.parseImageBlock)(kImageBlockWithTwoLocalizedImagesWrappedWithActualCaptionText.image);
+    expect(img.localizedUrls.length).toBe(2);
+    expect(img.localizedUrls[0].iso632Code).toBe("fr");
+    expect(img.localizedUrls[1].iso632Code).toBe("es");
+    expect(img.localizedUrls[0].url).toBe("https://i.imgur.com/pYmE7OJ.png");
+    expect(img.localizedUrls[1].url).toBe("https://i.imgur.com/8paSZ0i.png");
+}));
+const kImageBlockWithTwoLocalizedImagesWrappedWithActualCaptionText = {
+    object: "block",
+    id: "20b821b4-7c5b-41dc-8e30-92c23c125580",
+    parent: { type: "page_id", page_id: "9dd05134-0401-47f6-b159-1e6b76b9aad3" },
+    created_time: "2022-07-25T23:05:00.000Z",
+    last_edited_time: "2022-07-26T15:31:00.000Z",
+    created_by: { object: "user", id: "11fb7f16-0560-4aee-ab88-ed75a850cfc4" },
+    last_edited_by: {
+        object: "user",
+        id: "11fb7f16-0560-4aee-ab88-ed75a850cfc4",
+    },
+    has_children: false,
+    archived: false,
+    type: "image",
+    image: {
+        caption: [
+            {
+                type: "text",
+                text: { content: "Caption before images. fr-", link: null },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "Caption before images.\nfr ",
+                href: null,
+            },
+            {
+                type: "text",
+                text: {
+                    content: "https://i.imgur.com/pYmE7OJ.png",
+                    link: { url: "https://i.imgur.com/pYmE7OJ.png" },
+                },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "https://i.imgur.com/pYmE7OJ.png",
+                href: "https://i.imgur.com/pYmE7OJ.png",
+            },
+            {
+                type: "text",
+                text: { content: " es-", link: null },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "\nES  ",
+                href: null,
+            },
+            {
+                type: "text",
+                text: {
+                    content: "https://i.imgur.com/8paSZ0i.png",
+                    link: { url: "https://i.imgur.com/8paSZ0i.png" },
+                },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "https://i.imgur.com/8paSZ0i.png",
+                href: "https://i.imgur.com/8paSZ0i.png",
+            },
+            {
+                type: "text",
+                text: { content: "\nCaption after images", link: null },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "\nCaption after images.",
+                href: null,
+            },
+        ],
+        type: "file",
+        file: {
+            url: kPrimaryImageUrl,
+            expiry_time: "2022-07-26T16:35:44.029Z",
+        },
+    },
+};
+const kImageBlockWithTwoLocalizedImages = {
+    object: "block",
+    id: "20b821b4-7c5b-41dc-8e30-92c23c125580",
+    parent: {
+        type: "page_id",
+        page_id: "9dd05134-0401-47f6-b159-1e6b76b9aad3",
+    },
+    created_time: "2022-07-25T23:05:00.000Z",
+    last_edited_time: "2022-07-25T23:07:00.000Z",
+    created_by: {
+        object: "user",
+        id: "11fb7f16-0560-4aee-ab88-ed75a850cfc4",
+    },
+    last_edited_by: {
+        object: "user",
+        id: "11fb7f16-0560-4aee-ab88-ed75a850cfc4",
+    },
+    has_children: false,
+    archived: false,
+    type: "image",
+    image: {
+        caption: [
+            {
+                type: "text",
+                text: { content: "fr-", link: null },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "fr-",
+                href: null,
+            },
+            {
+                type: "text",
+                text: {
+                    content: "https://i.imgur.com/pYmE7OJ.png",
+                    link: { url: "https://i.imgur.com/pYmE7OJ.png" },
+                },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "https://i.imgur.com/pYmE7OJ.png",
+                href: "https://i.imgur.com/pYmE7OJ.png",
+            },
+            {
+                type: "text",
+                text: { content: " es-", link: null },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: " es-",
+                href: null,
+            },
+            {
+                type: "text",
+                text: {
+                    content: "https://i.imgur.com/8paSZ0i.png",
+                    link: { url: "https://i.imgur.com/8paSZ0i.png" },
+                },
+                annotations: {
+                    bold: false,
+                    italic: false,
+                    strikethrough: false,
+                    underline: false,
+                    code: false,
+                    color: "default",
+                },
+                plain_text: "https://i.imgur.com/8paSZ0i.png",
+                href: "https://i.imgur.com/8paSZ0i.png",
+            },
+        ],
+        type: "file",
+        file: {
+            url: kPrimaryImageUrl,
+            expiry_time: "2022-07-26T00:19:09.096Z",
+        },
+    },
+};

package/dist/NotionPage.d.ts

@@ -0,0 +1,44 @@
+import { GetPageResponse } from "@notionhq/client/build/src/api-endpoints";
+import { ListBlockChildrenResponseResults } from "notion-to-md/build/types";
+export declare enum PageType {
+    DatabasePage = 0,
+    Simple = 1
+}
+export declare class NotionPage {
+    metadata: GetPageResponse;
+    pageId: string;
+    order: number;
+    layoutContext: string;
+    foundDirectlyInOutline: boolean;
+    constructor(args: {
+        layoutContext: string;
+        pageId: string;
+        order: number;
+        metadata: GetPageResponse;
+        foundDirectlyInOutline: boolean;
+    });
+    matchesLinkId(id: string): boolean;
+    get type(): PageType;
+    get nameOrTitle(): string;
+    nameForFile(): string;
+    private get title();
+    private get name();
+    private explicitSlug;
+    get slug(): string;
+    get hasExplicitSlug(): boolean;
+    get keywords(): string | undefined;
+    get status(): string | undefined;
+    getPlainTextProperty(property: string, defaultIfEmpty: string): string;
+    getSelectProperty(property: string): string | undefined;
+    getContentInfo(children: ListBlockChildrenResponseResults): Promise<{
+        childPageIdsAndOrder: {
+            id: string;
+            order: number;
+        }[];
+        linksPageIdsAndOrder: {
+            id: string;
+            order: number;
+        }[];
+        hasParagraphs: boolean;
+    }>;
+}

package/dist/NotionPage.js

@@ -0,0 +1,194 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotionPage = exports.PageType = void 0;
+const internalLinks_1 = require("./plugins/internalLinks");
+// Notion has 2 kinds of pages: a normal one which is just content, and what I'm calling a "database page", which has whatever properties you put on it.
+// docu-notion supports the later via links from outline pages. That is, you put the database pages in a database, then separately, in the outline, you
+// create pages for each node of the outline and then add links from those to the database pages. In this way, we get the benefits of database
+// pages (metadata, workflow, etc) and also normal pages (order, position in the outline).
+var PageType;
+(function (PageType) {
+    PageType[PageType["DatabasePage"] = 0] = "DatabasePage";
+    PageType[PageType["Simple"] = 1] = "Simple";
+})(PageType = exports.PageType || (exports.PageType = {}));
+class NotionPage {
+    constructor(args) {
+        this.layoutContext = args.layoutContext;
+        this.pageId = args.pageId;
+        this.order = args.order;
+        this.metadata = args.metadata;
+        this.foundDirectlyInOutline = args.foundDirectlyInOutline;
+        // review: this is expensive to learn as it takes another api call... I
+        // think? We can tell if it's a database because it has a "Name" instead of a
+        // "tile" and "parent": "type": "database_id". But do we need to differentiate
+        //this.type = PageType.Unknown;
+    }
+    matchesLinkId(id) {
+        const { baseLinkId } = (0, internalLinks_1.parseLinkId)(id);
+        const match = baseLinkId === this.pageId || // from a link_to_page.pageId, which still has the dashes
+            baseLinkId === this.pageId.replaceAll("-", ""); // from inline links, which are lacking the dashes
+        // logDebug(
+        //   `matchedLinkId`,
+        //   `comparing pageId:${this.pageId} to id ${id} --> ${match.toString()}`
+        // );
+        return match;
+    }
+    get type() {
+        /*
+        {
+            "object": "page",
+            "parent": {
+                "type": "page_id",
+                or
+                "type": "database_id",
+                ...
+            },
+        */
+        return this.metadata.parent.type === "database_id"
+            ? PageType.DatabasePage
+            : PageType.Simple;
+    }
+    // In Notion, pages from the Database have names and simple pages have titles.
+    get nameOrTitle() {
+        return this.type === PageType.DatabasePage ? this.name : this.title;
+    }
+    nameForFile() {
+        var _a;
+        // In Notion, pages from the Database have names and simple pages have titles.
+        return this.type === PageType.Simple
+            ? this.title
+            : // if it's a Database page, then we'll use the slug unless there is none, then we'd rather have the
+                // page name than an ugly id for the file name
+                ((_a = this.explicitSlug()) === null || _a === void 0 ? void 0 : _a.replace(/^\//, "")) || this.name;
+    }
+    // TODO: let's go farther in hiding this separate title vs name stuff. This seems like an implementation detail on the Notion side.
+    // In Notion, pages from the Outline have "title"'s.
+    get title() {
+        return this.getPlainTextProperty("title", "title missing");
+    }
+    // In Notion, pages from the Database have "Name"s.
+    get name() {
+        return this.getPlainTextProperty("Name", "name missing");
+    }
+    explicitSlug() {
+        const explicitSlug = this.getPlainTextProperty("Slug", "");
+        if (explicitSlug) {
+            if (explicitSlug === "/")
+                return explicitSlug; // the root page
+            else
+                return ("/" +
+                    encodeURIComponent(explicitSlug
+                        .replace(/^\//, "")
+                        // If for some reason someone types in a slug with special characters,
+                        //we really don't want to see ugly entities in the URL, so first
+                        // we replace a bunch of likely suspects with dashes. This will not
+                        // adequately handle the case where there is one pag with slug:"foo-bar"
+                        // and another with "foo?bar". Both will come out "foo-bar"
+                        .replaceAll(" ", "-")
+                        .replaceAll("?", "-")
+                        .replaceAll("/", "-")
+                        .replaceAll("#", "-")
+                        .replaceAll("&", "-")
+                        .replaceAll("%", "-")
+                        // remove consecutive dashes
+                        .replaceAll("--", "-")));
+            return undefined; // this page has no slug property
+        }
+    }
+    get slug() {
+        var _a;
+        return (_a = this.explicitSlug()) !== null && _a !== void 0 ? _a : "/" + this.pageId;
+    }
+    get hasExplicitSlug() {
+        return this.explicitSlug() !== undefined;
+    }
+    get keywords() {
+        return this.getPlainTextProperty("Keywords", "");
+    }
+    get status() {
+        return this.getSelectProperty("Status");
+    }
+    getPlainTextProperty(property, defaultIfEmpty) {
+        /* Notion strings look like this
+       "properties": {
+          "slug": {
+            "type": "rich_text",
+            ...
+            "rich_text": [
+              {
+                ...
+                "plain_text": "/",
+              }
+            ]
+          },
+           "Name": {
+            "type": "title",
+            "title": [
+              {
+                ...
+                "plain_text": "Intro",
+              }
+            ]
+          */
+        var _a;
+        //console.log("metadata:\n" + JSON.stringify(this.metadata, null, 2));
+        const p = (_a = this.metadata.properties) === null || _a === void 0 ? void 0 : _a[property];
+        //console.log(`prop ${property} = ${JSON.stringify(p)}`);
+        if (!p)
+            return defaultIfEmpty;
+        const textArray = p[p.type];
+        //console.log("textarray:" + JSON.stringify(textArray, null, 2));
+        return textArray && textArray.length
+            ? textArray[0].plain_text
+            : defaultIfEmpty;
+    }
+    getSelectProperty(property) {
+        /* Notion select values look like this
+         "properties": {
+            "Status": {
+              "id": "oB~%3D",
+              "type": "select",
+              "select": {
+                "id": "1",
+                "name": "Ready For Review",
+                "color": "red"
+              }
+            },
+            */
+        var _a, _b;
+        const p = (_a = this.metadata.properties) === null || _a === void 0 ? void 0 : _a[property];
+        if (!p) {
+            throw new Error(`missing ${property} in ${JSON.stringify(this.metadata, null, 2)}`);
+            return undefined;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return ((_b = p.select) === null || _b === void 0 ? void 0 : _b.name) || undefined;
+    }
+    getContentInfo(children) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (let i = 0; i < children.length; i++) {
+                children[i].order = i;
+            }
+            return {
+                childPageIdsAndOrder: children
+                    .filter((b) => b.type === "child_page")
+                    .map((b) => ({ id: b.id, order: b.order })),
+                linksPageIdsAndOrder: children
+                    .filter((b) => b.type === "link_to_page")
+                    .map((b) => ({ id: b.link_to_page.page_id, order: b.order })),
+                hasParagraphs: children.some(b => b.type === "paragraph" &&
+                    b.paragraph.rich_text.length > 0),
+            };
+        });
+    }
+}
+exports.NotionPage = NotionPage;

package/dist/config/configuration.d.ts

@@ -0,0 +1,5 @@
+import { IPlugin } from "../plugins/pluginTypes";
+export type IDocuNotionConfig = {
+    plugins: IPlugin[];
+};
+export declare function loadConfigAsync(): Promise<IDocuNotionConfig>;

package/dist/config/configuration.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfigAsync = void 0;
+const Cosmic = __importStar(require("cosmiconfig"));
+const default_docunotion_config_1 = __importDefault(require("./default.docunotion.config"));
+const log_1 = require("../log");
+const cosmiconfig_typescript_loader_1 = require("cosmiconfig-typescript-loader");
+const process_1 = require("process");
+// read the plugins from the config file
+// and add them to the map
+function loadConfigAsync() {
+    var _a, _b, _c, _d, _e;
+    return __awaiter(this, void 0, void 0, function* () {
+        let config = default_docunotion_config_1.default;
+        try {
+            const cosmic = Cosmic.cosmiconfig("docu-notion", {
+                loaders: {
+                    ".ts": (0, cosmiconfig_typescript_loader_1.TypeScriptLoader)(),
+                },
+                searchPlaces: [`docu-notion.config.ts`],
+            });
+            const found = yield cosmic.search();
+            if (found) {
+                (0, log_1.verbose)(`Loading config from ${found.filepath}`);
+            }
+            else {
+                (0, log_1.verbose)(`Did not find configuration file, using defaults.`);
+            }
+            const pluginsWithInitializers = (_b = (_a = found === null || found === void 0 ? void 0 : found.config) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.filter((p) => p.init !== undefined);
+            const initializers = pluginsWithInitializers === null || pluginsWithInitializers === void 0 ? void 0 : pluginsWithInitializers.map((p) => () => p.init(p));
+            yield Promise.all(initializers || []);
+            (_d = (_c = found === null || found === void 0 ? void 0 : found.config) === null || _c === void 0 ? void 0 : _c.plugins) === null || _d === void 0 ? void 0 : _d.forEach((plugin) => __awaiter(this, void 0, void 0, function* () {
+                if (plugin.init !== undefined) {
+                    (0, log_1.verbose)(`Initializing plugin ${plugin.name}...`);
+                    yield plugin.init(plugin);
+                }
+            }));
+            // for now, all we have is plugins
+            config = {
+                plugins: default_docunotion_config_1.default.plugins.concat(((_e = found === null || found === void 0 ? void 0 : found.config) === null || _e === void 0 ? void 0 : _e.plugins) || []),
+            };
+        }
+        catch (e) {
+            (0, log_1.error)(e.message);
+            (0, process_1.exit)(1);
+        }
+        (0, log_1.verbose)(`Active plugins: [${config.plugins.map(p => p.name).join(", ")}]`);
+        return config;
+    });
+}
+exports.loadConfigAsync = loadConfigAsync;

package/dist/config/default.docunotion.config.d.ts

@@ -0,0 +1,3 @@
+import { IDocuNotionConfig } from "./configuration";
+declare const defaultConfig: IDocuNotionConfig;
+export default defaultConfig;

package/dist/config/default.docunotion.config.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const embedTweaks_1 = require("../plugins/embedTweaks");
+const images_1 = require("../images");
+const internalLinks_1 = require("../plugins/internalLinks");
+const CalloutTransformer_1 = require("../plugins/CalloutTransformer");
+const ColumnListTransformer_1 = require("../plugins/ColumnListTransformer");
+const ColumnTransformer_1 = require("../plugins/ColumnTransformer");
+const EscapeHtmlBlockModifier_1 = require("../plugins/EscapeHtmlBlockModifier");
+const HeadingTransformer_1 = require("../plugins/HeadingTransformer");
+const NumberedListTransformer_1 = require("../plugins/NumberedListTransformer");
+const TableTransformer_1 = require("../plugins/TableTransformer");
+const externalLinks_1 = require("../plugins/externalLinks");
+const defaultConfig = {
+    plugins: [
+        // Notion "Block" JSON modifiers
+        EscapeHtmlBlockModifier_1.standardEscapeHtmlBlockModifier,
+        HeadingTransformer_1.standardHeadingTransformer,
+        // Notion to Markdown transformers. Most things get transformed correctly by the notion-to-markdown library,
+        // but some things need special handling.
+        ColumnTransformer_1.standardColumnTransformer,
+        ColumnListTransformer_1.standardColumnListTransformer,
+        images_1.standardImageTransformer,
+        CalloutTransformer_1.standardCalloutTransformer,
+        TableTransformer_1.standardTableTransformer,
+        NumberedListTransformer_1.standardNumberedListTransformer,
+        // Link modifiers, which are special because they can read metadata from all the pages in order to figure out the correct url
+        internalLinks_1.standardInternalLinkConversion,
+        externalLinks_1.standardExternalLinkConversion,
+        // Regexps plus javascript `import`s that operate on the Markdown output
+        embedTweaks_1.imgurGifEmbed,
+        embedTweaks_1.gifEmbed,
+        embedTweaks_1.youtubeEmbed,
+        embedTweaks_1.vimeoEmbed,
+    ],
+};
+exports.default = defaultConfig;

package/dist/images.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import { FileTypeResult } from "file-type";
+import { ListBlockChildrenResponseResult } from "notion-to-md/build/types";
+import { IPlugin } from "./plugins/pluginTypes";
+export type ImageSet = {
+    primaryUrl: string;
+    caption?: string;
+    localizedUrls: Array<{
+        iso632Code: string;
+        url: string;
+    }>;
+    pathToParentDocument?: string;
+    relativePathToParentDocument?: string;
+    primaryBuffer?: Buffer;
+    fileType?: FileTypeResult;
+    primaryFileOutputPath?: string;
+    outputFileName?: string;
+    filePathToUseInMarkdown?: string;
+};
+export declare function initImageHandling(prefix: string, outputPath: string, incomingLocales: string[]): Promise<void>;
+export declare const standardImageTransformer: IPlugin;
+export declare function markdownToMDImageTransformer(block: ListBlockChildrenResponseResult, fullPathToDirectoryContainingMarkdown: string, relativePathToThisPage: string): Promise<string>;
+export declare function parseImageBlock(image: any): ImageSet;
+export declare function cleanupOldImages(): Promise<void>;