@odg/command 1.13.0 → 1.15.0

package/dist/Registrations/register.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerArtifact = registerArtifact;
+const node_path_1 = require("node:path");
+const exception_1 = require("@odg/exception");
+const pascal_to_dot_lower_1 = require("./pascal-to-dot-lower");
+const ts_mutators_1 = require("./ts-mutators");
+/** TypeScript path alias for the listeners barrel (see tsconfig paths). */
+const listenersTypeModuleSpecifier = "@listeners";
+/** TypeScript path alias for the pages barrel (see tsconfig paths). */
+const pagesTypeModuleSpecifier = "@pages";
+/** TypeScript path alias for the handlers barrel (see tsconfig paths). */
+const handlersTypeModuleSpecifier = "@handlers";
+function resolveRelativeExportPath(filePath, barrelPath, fallbackExportName) {
+    if (!filePath) {
+        return `./${fallbackExportName}`;
+    }
+    const barrelDirectory = (0, node_path_1.dirname)(barrelPath);
+    const filePathWithoutExtension = filePath.replace(/\.ts$/, "");
+    const relativePath = (0, node_path_1.relative)(barrelDirectory, filePathWithoutExtension);
+    return `./${relativePath}`;
+}
+async function registerContainerEnumMember(containerEnumPath, memberName, memberValue) {
+    await (0, ts_mutators_1.ensureEnumMember)({
+        filePath: containerEnumPath,
+        enumName: "ContainerName",
+        memberName,
+        memberValue,
+    });
+}
+async function registerContainerInterfaceBinding(containerInterfacePath, enumMember, className, moduleSpecifier) {
+    await (0, ts_mutators_1.ensureValueNamedImport)({
+        filePath: containerInterfacePath,
+        moduleSpecifier,
+        name: className,
+    });
+    await (0, ts_mutators_1.ensureInterfaceProperty)({
+        filePath: containerInterfacePath,
+        interfaceName: "ContainerInterface",
+        propertyName: `[ContainerName.${enumMember}]`,
+        propertyType: className,
+    });
+}
+async function registerBarrelExport(barrelPath, filePath, fallbackExportName) {
+    const relativeExportPath = resolveRelativeExportPath(filePath, barrelPath, fallbackExportName);
+    await (0, ts_mutators_1.ensureBarrelExport)({
+        barrelPath,
+        relativeExportPath,
+    });
+}
+async function registerConfigEnumMembers(descriptor, targets) {
+    if (!descriptor.configEnumMembers?.length || !targets.configEnumPath) {
+        return;
+    }
+    for (const key of descriptor.configEnumMembers) {
+        await (0, ts_mutators_1.ensureEnumMember)({
+            filePath: targets.configEnumPath,
+            enumName: "ConfigName",
+            memberName: key,
+            memberValue: key,
+        });
+    }
+}
+async function registerEnvironmentExampleLines(descriptor, targets) {
+    if (!descriptor.envExampleLines?.length || !targets.envExamplePath) {
+        return;
+    }
+    await (0, ts_mutators_1.ensureEnvironmentExampleLines)({
+        filePath: targets.envExamplePath,
+        lines: descriptor.envExampleLines,
+    });
+}
+async function registerImports(targets) {
+    const imports = targets.typeImports ?? [];
+    if (imports.length === 0)
+        return;
+    const importTargets = new Set([
+        targets.containerEnumPath,
+        targets.eventEnumPath,
+        targets.configEnumPath,
+        targets.containerInterfacePath,
+        targets.eventsInterfacePath,
+        targets.pagesIndexPath,
+        targets.selectorsIndexPath,
+        targets.handlersIndexPath,
+        targets.listenersIndexPath,
+    ].filter(Boolean));
+    await Promise.all([...importTargets].map(async (filePath) => (0, ts_mutators_1.ensureTopLevelStatements)({
+        filePath,
+        statements: imports,
+    })));
+}
+async function registerPage(descriptor, targets) {
+    if (descriptor.containerEnumMember && targets.containerEnumPath) {
+        await registerContainerEnumMember(targets.containerEnumPath, descriptor.containerEnumMember, (0, pascal_to_dot_lower_1.resolveContainerEnumMemberValue)(undefined, descriptor.containerEnumMember));
+    }
+    if (descriptor.pageClassName && targets.pagesIndexPath) {
+        await registerBarrelExport(targets.pagesIndexPath, descriptor.filePath, descriptor.pageClassName);
+    }
+    if (descriptor.containerEnumMember && descriptor.pageClassName && targets.containerInterfacePath) {
+        await registerContainerInterfaceBinding(targets.containerInterfacePath, descriptor.containerEnumMember, descriptor.pageClassName, pagesTypeModuleSpecifier);
+    }
+    await registerConfigEnumMembers(descriptor, targets);
+    await registerEnvironmentExampleLines(descriptor, targets);
+}
+async function registerSelector(descriptor, targets) {
+    if (!descriptor.selectorClassName || !targets.selectorsIndexPath)
+        return;
+    await registerBarrelExport(targets.selectorsIndexPath, descriptor.filePath, descriptor.selectorClassName);
+}
+async function registerHandler(descriptor, targets) {
+    if (descriptor.containerEnumMember && targets.containerEnumPath) {
+        await registerContainerEnumMember(targets.containerEnumPath, descriptor.containerEnumMember, (0, pascal_to_dot_lower_1.resolveContainerEnumMemberValue)(undefined, descriptor.containerEnumMember));
+    }
+    if (descriptor.handlerClassName && targets.handlersIndexPath) {
+        await registerBarrelExport(targets.handlersIndexPath, descriptor.filePath, descriptor.handlerClassName);
+    }
+    if (descriptor.containerEnumMember && descriptor.handlerClassName && targets.containerInterfacePath) {
+        await registerContainerInterfaceBinding(targets.containerInterfacePath, descriptor.containerEnumMember, descriptor.handlerClassName, handlersTypeModuleSpecifier);
+    }
+}
+async function registerEventsInterface(descriptor, targets) {
+    const payloadType = targets.eventPayloadType;
+    if (!payloadType || !descriptor.eventEnumMember || !targets.eventsInterfacePath) {
+        throw new exception_1.InvalidArgumentException("Missing explicit event payload type: pass --eventPayloadType to register EventsInterface safely.");
+    }
+    await (0, ts_mutators_1.ensureInterfaceProperty)({
+        filePath: targets.eventsInterfacePath,
+        interfaceName: "EventBaseInterface",
+        propertyName: `[EventName.${descriptor.eventEnumMember}]`,
+        propertyType: payloadType,
+    });
+}
+async function registerEventContainerInterface(descriptor, targets) {
+    if (!descriptor.listenerClassName
+        || !descriptor.containerEnumMember
+        || !targets.containerInterfacePath) {
+        return;
+    }
+    await (0, ts_mutators_1.ensureTypeNamedImport)({
+        filePath: targets.containerInterfacePath,
+        moduleSpecifier: listenersTypeModuleSpecifier,
+        name: descriptor.listenerClassName,
+    });
+    await (0, ts_mutators_1.ensureInterfaceProperty)({
+        filePath: targets.containerInterfacePath,
+        interfaceName: "ContainerInterface",
+        propertyName: `[ContainerName.${descriptor.containerEnumMember}]`,
+        propertyType: descriptor.listenerClassName,
+    });
+}
+async function registerEvent(descriptor, targets) {
+    if (descriptor.eventEnumMember && targets.eventEnumPath) {
+        await (0, ts_mutators_1.ensureEnumMember)({
+            filePath: targets.eventEnumPath,
+            enumName: "EventName",
+            memberName: descriptor.eventEnumMember,
+            memberValue: descriptor.eventEnumMember,
+        });
+    }
+    if (descriptor.eventEnumMember && targets.eventsInterfacePath) {
+        await registerEventsInterface(descriptor, targets);
+    }
+}
+async function registerListener(descriptor, targets) {
+    if (!descriptor.listenerClassName || !descriptor.containerEnumMember) {
+        return;
+    }
+    if (targets.listenersIndexPath) {
+        await registerBarrelExport(targets.listenersIndexPath, descriptor.filePath, descriptor.listenerClassName);
+    }
+    if (descriptor.containerEnumMember && targets.containerEnumPath) {
+        await (0, ts_mutators_1.ensureEnumMember)({
+            filePath: targets.containerEnumPath,
+            enumName: "ContainerName",
+            memberName: descriptor.containerEnumMember,
+            memberValue: (0, pascal_to_dot_lower_1.resolveContainerEnumMemberValue)(targets.containerEnumMemberValue, descriptor.containerEnumMember),
+        });
+    }
+    await registerEventContainerInterface(descriptor, targets);
+}
+async function registerConfig(descriptor, targets) {
+    await registerConfigEnumMembers(descriptor, targets);
+    await registerEnvironmentExampleLines(descriptor, targets);
+    if (!descriptor.configEnumMembers?.length || !targets.configValidatorPath) {
+        return;
+    }
+    for (const key of descriptor.configEnumMembers) {
+        await (0, ts_mutators_1.ensureZodObjectEntry)({
+            filePath: targets.configValidatorPath,
+            constName: "configValidator",
+            propertyName: `[ConfigName.${key}]`,
+            propertyValue: descriptor.configValidatorType ?? "zod.string()",
+        });
+    }
+}
+async function registerArtifact(descriptor, targets) {
+    if (!targets.enabled)
+        return;
+    await registerImports(targets);
+    switch (descriptor.kind) {
+        case "page":
+            await registerPage(descriptor, targets);
+            break;
+        case "selector":
+            await registerSelector(descriptor, targets);
+            break;
+        case "handler":
+            await registerHandler(descriptor, targets);
+            break;
+        case "event":
+            await registerEvent(descriptor, targets);
+            break;
+        case "listener":
+            await registerListener(descriptor, targets);
+            break;
+        case "config":
+            await registerConfig(descriptor, targets);
+            break;
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/Registrations/register.js.map

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

package/dist/Registrations/ts-mutators.d.ts

@@ -0,0 +1,41 @@
+export declare function ensureEnumMember(parameters: {
+    filePath: string;
+    enumName: string;
+    memberName: string;
+    memberValue?: string;
+}): Promise<boolean>;
+export declare function ensureBarrelExport(parameters: {
+    barrelPath: string;
+    relativeExportPath: string;
+}): Promise<boolean>;
+export declare function ensureTopLevelStatements(parameters: {
+    filePath: string;
+    statements: string[];
+}): Promise<boolean>;
+export declare function ensureInterfaceProperty(parameters: {
+    filePath: string;
+    interfaceName: string;
+    propertyName: string;
+    propertyType: string;
+}): Promise<boolean>;
+export declare function ensureEnvironmentExampleLines(parameters: {
+    filePath: string;
+    lines: string[];
+}): Promise<boolean>;
+export declare function ensureZodObjectEntry(parameters: {
+    filePath: string;
+    constName: string;
+    propertyName: string;
+    propertyValue: string;
+}): Promise<boolean>;
+export declare function ensureTypeNamedImport(parameters: {
+    filePath: string;
+    moduleSpecifier: string;
+    name: string;
+}): Promise<boolean>;
+export declare function ensureValueNamedImport(parameters: {
+    filePath: string;
+    moduleSpecifier: string;
+    name: string;
+}): Promise<boolean>;
+//# sourceMappingURL=ts-mutators.d.ts.map

package/dist/Registrations/ts-mutators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-mutators.d.ts","sourceRoot":"","sources":["../../src/Registrations/ts-mutators.ts"],"names":[],"mappings":"AAuIA,wBAAsB,gBAAgB,CAAC,UAAU,EAAE;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BnB;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBnB;AAED,wBAAsB,wBAAwB,CAAC,UAAU,EAAE;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBnB;AAED,wBAAsB,uBAAuB,CAAC,UAAU,EAAE;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBnB;AAED,wBAAsB,6BAA6B,CAAC,UAAU,EAAE;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBnB;AAED,wBAAsB,oBAAoB,CAAC,UAAU,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBnB;AAED,wBAAsB,qBAAqB,CAAC,UAAU,EAAE;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB;AAED,wBAAsB,sBAAsB,CAAC,UAAU,EAAE;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnB"}

package/dist/Registrations/ts-mutators.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureEnumMember = ensureEnumMember;
+exports.ensureBarrelExport = ensureBarrelExport;
+exports.ensureTopLevelStatements = ensureTopLevelStatements;
+exports.ensureInterfaceProperty = ensureInterfaceProperty;
+exports.ensureEnvironmentExampleLines = ensureEnvironmentExampleLines;
+exports.ensureZodObjectEntry = ensureZodObjectEntry;
+exports.ensureTypeNamedImport = ensureTypeNamedImport;
+exports.ensureValueNamedImport = ensureValueNamedImport;
+const exception_1 = require("@odg/exception");
+const ts_morph_1 = require("ts-morph");
+function createProject() {
+    return new ts_morph_1.Project({
+        manipulationSettings: {
+            quoteKind: ts_morph_1.QuoteKind.Double,
+            useTrailingCommas: true,
+        },
+        skipAddingFilesFromTsConfig: true,
+    });
+}
+function addSourceFile(project, filePath) {
+    return project.addSourceFileAtPathIfExists(filePath)
+        ?? project.createSourceFile(filePath, "", { scriptKind: ts_morph_1.ScriptKind.TS, overwrite: false });
+}
+/**
+ * Collapses duplicate commas that ts-morph can emit when appending enum members
+ * (e.g. after trailing commas and section comments).
+ *
+ * @param {string} source Full source text
+ * @returns {string} Source with adjacent duplicate commas normalized
+ */
+function collapseAdjacentDuplicateCommas(source) {
+    let result = source;
+    let previous = "";
+    while (result !== previous) {
+        previous = result;
+        result = result.replaceAll(/,\s*,/g, ",");
+    }
+    return result;
+}
+function appendNamedImport(importDeclaration, name) {
+    const hasNamed = importDeclaration.getNamedImports().some((named) => named.getName() === name);
+    if (hasNamed) {
+        return false;
+    }
+    importDeclaration.addNamedImport({ name });
+    return true;
+}
+function mutateNamedImport(sourceFile, moduleSpecifier, name, isTypeOnly) {
+    const importDeclaration = sourceFile.getImportDeclarations().find((declaration) => declaration.getModuleSpecifierValue() === moduleSpecifier
+        && declaration.isTypeOnly() === isTypeOnly);
+    if (importDeclaration) {
+        return appendNamedImport(importDeclaration, name);
+    }
+    sourceFile.addImportDeclaration({
+        isTypeOnly,
+        namedImports: [{ name }],
+        moduleSpecifier,
+    });
+    return true;
+}
+async function commitNamedImport(parameters, isTypeOnly) {
+    const project = createProject();
+    const sourceFile = addSourceFile(project, parameters.filePath);
+    if (!mutateNamedImport(sourceFile, parameters.moduleSpecifier, parameters.name, isTypeOnly)) {
+        return false;
+    }
+    await sourceFile.save();
+    return true;
+}
+function resolveZodObjectLiteral(parameters, sourceFile) {
+    const variableDeclaration = sourceFile
+        .getVariableDeclarations()
+        .find((declaration) => declaration.getName() === parameters.constName);
+    if (!variableDeclaration) {
+        throw new exception_1.InvalidArgumentException(`Const "${parameters.constName}" not found in ${parameters.filePath}`);
+    }
+    const initializer = variableDeclaration.getInitializer();
+    if (!initializer || !ts_morph_1.Node.isCallExpression(initializer)) {
+        throw new exception_1.InvalidArgumentException(`"${parameters.constName}" initializer is not a call expression`);
+    }
+    const [firstArgument] = initializer.getArguments();
+    if (!ts_morph_1.Node.isObjectLiteralExpression(firstArgument)) {
+        throw new exception_1.InvalidArgumentException(`"${parameters.constName}" first argument is not an object literal`);
+    }
+    return firstArgument;
+}
+function hasObjectPropertyByNamePrefix(objectLiteral, propertyName) {
+    return objectLiteral.getProperties().some((property) => property.getText().startsWith(propertyName));
+}
+async function ensureEnumMember(parameters) {
+    const project = createProject();
+    const sourceFile = addSourceFile(project, parameters.filePath);
+    const enumDeclaration = sourceFile.getEnum(parameters.enumName);
+    if (!enumDeclaration) {
+        throw new exception_1.InvalidArgumentException(`Enum "${parameters.enumName}" not found in ${parameters.filePath}`);
+    }
+    const existing = enumDeclaration.getMembers().some((member) => {
+        const memberName = member.getName().split("\"").join("");
+        return memberName === parameters.memberName;
+    });
+    if (existing) {
+        return false;
+    }
+    enumDeclaration.addMember({
+        name: `"${parameters.memberName}"`,
+        initializer: `"${parameters.memberValue ?? parameters.memberName}"`,
+    });
+    sourceFile.replaceWithText(collapseAdjacentDuplicateCommas(sourceFile.getFullText()));
+    await sourceFile.save();
+    return true;
+}
+async function ensureBarrelExport(parameters) {
+    const project = createProject();
+    const sourceFile = addSourceFile(project, parameters.barrelPath);
+    const normalized = parameters.relativeExportPath.startsWith("./")
+        ? parameters.relativeExportPath
+        : `./${parameters.relativeExportPath}`;
+    // eslint-disable-next-line @stylistic/max-len
+    const already = sourceFile.getExportDeclarations().some((declaration) => declaration.getModuleSpecifierValue() === normalized);
+    if (already) {
+        return false;
+    }
+    sourceFile.addExportDeclaration({
+        moduleSpecifier: normalized,
+        isTypeOnly: false,
+    });
+    await sourceFile.save();
+    return true;
+}
+async function ensureTopLevelStatements(parameters) {
+    if (parameters.statements.length === 0) {
+        return false;
+    }
+    const project = createProject();
+    const sourceFile = addSourceFile(project, parameters.filePath);
+    const text = sourceFile.getFullText();
+    const toAdd = parameters.statements.filter((statement) => !text.includes(statement));
+    if (toAdd.length === 0) {
+        return false;
+    }
+    sourceFile.insertStatements(0, `${toAdd.join("\n")}\n`);
+    await sourceFile.save();
+    return true;
+}
+async function ensureInterfaceProperty(parameters) {
+    const project = createProject();
+    const sourceFile = addSourceFile(project, parameters.filePath);
+    const iface = sourceFile.getInterface(parameters.interfaceName);
+    if (!iface) {
+        throw new exception_1.InvalidArgumentException(`Interface "${parameters.interfaceName}" not found in ${parameters.filePath}`);
+    }
+    const exists = iface.getProperties().some((property) => property.getName() === parameters.propertyName);
+    if (exists) {
+        return false;
+    }
+    iface.addProperty({
+        name: parameters.propertyName,
+        type: parameters.propertyType,
+        hasQuestionToken: false,
+    });
+    await sourceFile.save();
+    return true;
+}
+async function ensureEnvironmentExampleLines(parameters) {
+    const project = createProject();
+    const sourceFile = addSourceFile(project, parameters.filePath);
+    /**
+     * This file can be non-TS; we treat it as raw text but keep a single write path.
+     */
+    const existing = sourceFile.getFullText();
+    const missing = parameters.lines.filter((line) => !existing.includes(line));
+    if (missing.length === 0) {
+        return false;
+    }
+    const insertNewline = existing.endsWith("\n") || existing.length === 0 ? "" : "\n";
+    sourceFile.replaceWithText(`${existing}${insertNewline}${missing.join("\n")}\n`);
+    await sourceFile.save();
+    return true;
+}
+async function ensureZodObjectEntry(parameters) {
+    const project = createProject();
+    const sourceFile = addSourceFile(project, parameters.filePath);
+    const zodObjectLiteral = resolveZodObjectLiteral(parameters, sourceFile);
+    if (hasObjectPropertyByNamePrefix(zodObjectLiteral, parameters.propertyName)) {
+        return false;
+    }
+    zodObjectLiteral.addPropertyAssignment({
+        name: parameters.propertyName,
+        initializer: parameters.propertyValue,
+    });
+    await sourceFile.save();
+    return true;
+}
+async function ensureTypeNamedImport(parameters) {
+    return commitNamedImport(parameters, true);
+}
+async function ensureValueNamedImport(parameters) {
+    return commitNamedImport(parameters, false);
+}
+//# sourceMappingURL=ts-mutators.js.map

package/dist/Registrations/ts-mutators.js.map

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

package/dist/Registrations/types.d.ts

@@ -0,0 +1,35 @@
+export type ArtifactKind = "config" | "event" | "handler" | "listener" | "page" | "selector";
+export interface RegistrationTargets {
+    enabled: boolean;
+    containerEnumPath?: string;
+    eventEnumPath?: string;
+    configEnumPath?: string;
+    containerInterfacePath?: string;
+    eventsInterfacePath?: string;
+    pagesIndexPath?: string;
+    selectorsIndexPath?: string;
+    handlersIndexPath?: string;
+    listenersIndexPath?: string;
+    envExamplePath?: string;
+    /** Path to the file containing `configValidator = zod.object({...})` to mutate. */
+    configValidatorPath?: string;
+    eventPayloadType?: string;
+    typeImports?: string[];
+    /** Overrides ContainerName enum value for event/listener registration (default: dot.lower from class name). */
+    containerEnumMemberValue?: string;
+}
+export interface ArtifactDescriptor {
+    kind: ArtifactKind;
+    name: string;
+    pageClassName?: string;
+    selectorClassName?: string;
+    handlerClassName?: string;
+    eventEnumMember?: string;
+    listenerClassName?: string;
+    containerEnumMember?: string;
+    filePath?: string;
+    configEnumMembers?: string[];
+    envExampleLines?: string[];
+    configValidatorType?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/Registrations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Registrations/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7F,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IAGjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mFAAmF;IACnF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,+GAA+G;IAC/G,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,YAAY,CAAC;IAGnB,IAAI,EAAE,MAAM,CAAC;IAGb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAG3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/Registrations/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/Registrations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/Registrations/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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