@microsoft/managed-apps-codegen 0.2.1

package/dist/shared/dataverseUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataverseUtils.d.ts","sourceRoot":"","sources":["../../src/shared/dataverseUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAOxD;AAED,+GAA+G;AAC/G,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQtE;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAExE;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAQ7F;AAED,2HAA2H;AAC3H,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAOT;AAED,kHAAkH;AAClH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,8EAA8E;AAC9E,wBAAgB,+BAA+B,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAoBzE;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CAAC,cAAc,EAAE,UAAU,GAAG,MAAM,EAAE,CAa1F;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAK/D;AAED,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,eAAe,GAAG,QAAQ,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AACF,KAAK,YAAY,GAAG;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wIAAwI;AACxI,wBAAiB,0BAA0B,CACzC,cAAc,EAAE,UAAU,EAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACrC,SAAS,CAAC,aAAa,GAAG,YAAY,CAAC,CAezC"}

package/dist/shared/dataverseUtils.js

@@ -0,0 +1,138 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { hasEnumValues, isJsonObject } from './schemaUtils.js';
+/** Returns true if the schema root represents a Dataverse entity table. */
+export function isDataverseEntity(root) {
+    return (isJsonObject(root) &&
+        isJsonObject(root.schema) &&
+        isJsonObject(root.schema.items) &&
+        root.schema.items['x-ms-dataverse-entity'] === true);
+}
+/** Returns the Dataverse entity set name for a schema (used as the OData API path), or null if not defined. */
+export function getDataverseEntitySetName(root) {
+    if (isJsonObject(root) && isJsonObject(root.schema) && isJsonObject(root.schema.items)) {
+        const entitySetName = root.schema.items['x-ms-dataverse-entityset'];
+        if (typeof entitySetName === 'string' && entitySetName.trim()) {
+            return entitySetName;
+        }
+    }
+    return null;
+}
+/** Returns true if the property is a Dataverse lookup relationship to another table. */
+export function isDataverseLookupProperty(propValue) {
+    return propValue['x-ms-dataverse-type'] === 'LookupType';
+}
+/** Collects all lookup relationship columns from a properties node, keyed by property name. */
+export function getDataverseLookupColumns(propertiesNode) {
+    const lookupColumns = new Map();
+    for (const [propName, propValue] of Object.entries(propertiesNode)) {
+        if (isJsonObject(propValue) && isDataverseLookupProperty(propValue)) {
+            lookupColumns.set(propName, propValue);
+        }
+    }
+    return lookupColumns;
+}
+/** Returns true if the property is an auto-generated name field for a lookup column (e.g. `owneridname` for `ownerid`). */
+export function isLookupRelatedProperty(propName, lookupColumns) {
+    for (const lookupPropName of lookupColumns.keys()) {
+        if (propName === `${lookupPropName}name`) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Returns the write-form property name for a lookup column, used when creating or updating Dataverse records. */
+export function generateODataBindPropertyName(schemaName) {
+    return `${schemaName}@odata.bind`;
+}
+/** Returns the read-form property name for a lookup's resolved GUID value. */
+export function generateLookupValuePropertyName(lookupPropertyName) {
+    return `_${lookupPropertyName}_value`;
+}
+/**
+ * Returns true if the property is a Dataverse boolean (yes/no) field.
+ * These fields have enum/x-ms-enum-values in the schema but must be typed as `boolean`,
+ * not as a numeric optionset, because the Dataverse Web API expects true/false.
+ */
+export function isDataverseBooleanProperty(propValue) {
+    return (propValue['x-ms-dataverse-type'] === 'BooleanType' ||
+        propValue['x-ms-optionSetType'] === 'Boolean');
+}
+/**
+ * Returns true if the property is a Dataverse numeric field (integer, decimal, double, money, bigint).
+ * These fields have `"type": "string"` in the schema but must be typed as `number` because
+ * the Dataverse Web API sends and receives them as JSON numbers.
+ */
+export function isDataverseNumericProperty(propValue) {
+    const dvType = typeof propValue['x-ms-dataverse-type'] === 'string'
+        ? propValue['x-ms-dataverse-type'].toLowerCase()
+        : undefined;
+    switch (dvType) {
+        case 'integer':
+        case 'integertype':
+        case 'bigint':
+        case 'biginttype':
+        case 'decimal':
+        case 'decimaltype':
+        case 'double':
+        case 'doubletype':
+        case 'money':
+        case 'moneytype':
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Returns true if the property is a Dataverse multi-select picklist (multi-choice) field.
+ * These fields allow multiple selections and should be typed as an array of the enum type.
+ */
+export function isDataverseMultiSelectPicklistProperty(propValue) {
+    return propValue['x-ms-dataverse-type'] === 'MultiSelectPicklistType';
+}
+/**
+ * Returns the names of all MultiSelectPicklist (multi-choice) properties in a Dataverse entity
+ * properties node — i.e., properties that have optionset data AND are typed as MultiSelectPicklistType.
+ * These fields require serialization (array → comma-separated string) when writing to the Dataverse API
+ * and deserialization (comma-separated string → array) when reading back from it.
+ */
+export function getDataverseMultiSelectPicklistFields(propertiesNode) {
+    const fields = [];
+    for (const [propName, propValue] of Object.entries(propertiesNode)) {
+        if (isJsonObject(propValue) &&
+            isDataverseMultiSelectPicklistProperty(propValue) &&
+            Array.isArray(propValue.enum) &&
+            propValue.enum.length > 0) {
+            fields.push(propName);
+        }
+    }
+    return fields;
+}
+/** Returns true if the property represents an optionset (choice) column with enumerable values. */
+export function hasOptionsetData(propValue) {
+    if (isDataverseBooleanProperty(propValue)) {
+        return false;
+    }
+    return hasEnumValues(propValue);
+}
+/** Yields each property in a Dataverse entity's properties node, tagged by its role and mutability, for use in interface generation. */
+export function* iterateDataverseProperties(propertiesNode, lookupColumns) {
+    for (const [propName, propValue] of Object.entries(propertiesNode)) {
+        if (isJsonObject(propValue)) {
+            const readOnly = !!propValue['x-ms-read-only'];
+            if (lookupColumns.has(propName)) {
+                const schemaNameRaw = propValue['x-ms-schema-name'];
+                const schemaName = typeof schemaNameRaw === 'string' ? schemaNameRaw : propName;
+                yield { type: 'lookup', readOnly, propName, propValue, schemaName };
+            }
+            else if (isLookupRelatedProperty(propName, lookupColumns)) {
+                yield { type: 'lookupRelated', readOnly, propName, propValue };
+            }
+            else {
+                yield { type: 'normal', readOnly, propName, propValue };
+            }
+        }
+    }
+}
+//# sourceMappingURL=dataverseUtils.js.map

package/dist/shared/dataverseUtils.js.map

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

package/dist/shared/flowUtils.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/** The full API ID for Power Automate flows used in connection references and codegen dispatch. */
+export declare const LOGIC_FLOWS_API_ID = "/providers/Microsoft.PowerApps/apis/shared_logicflows";
+/**
+ * Returns true if the schema's `id` field identifies it as a Power Automate Logic Flow connector.
+ * Used during service generation to suppress internal parameters from the method signature.
+ */
+export declare function isLogicFlowSchema(schema: unknown): boolean;
+//# sourceMappingURL=flowUtils.d.ts.map

package/dist/shared/flowUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowUtils.d.ts","sourceRoot":"","sources":["../../src/shared/flowUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,0DAA0D,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAK1D"}

package/dist/shared/flowUtils.js

@@ -0,0 +1,16 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { equalsIgnoreCase } from '@microsoft/managed-apps-common/utils';
+import { isJsonObject } from './schemaUtils.js';
+/** The full API ID for Power Automate flows used in connection references and codegen dispatch. */
+export const LOGIC_FLOWS_API_ID = '/providers/Microsoft.PowerApps/apis/shared_logicflows';
+/**
+ * Returns true if the schema's `id` field identifies it as a Power Automate Logic Flow connector.
+ * Used during service generation to suppress internal parameters from the method signature.
+ */
+export function isLogicFlowSchema(schema) {
+    return (isJsonObject(schema) &&
+        equalsIgnoreCase(schema.id, LOGIC_FLOWS_API_ID));
+}
+//# sourceMappingURL=flowUtils.js.map

package/dist/shared/flowUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowUtils.js","sourceRoot":"","sources":["../../src/shared/flowUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,mGAAmG;AACnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,uDAAuD,CAAC;AAE1F;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,OAAO,CACL,YAAY,CAAC,MAAM,CAAC;QACpB,gBAAgB,CAAC,MAAM,CAAC,EAA+B,EAAE,kBAAkB,CAAC,CAC7E,CAAC;AACJ,CAAC"}

package/dist/shared/nameUtils.d.ts

@@ -0,0 +1,33 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/** Converts an arbitrary string to a safe TypeScript identifier for use in generated code. */
+export declare function convertToValidIdentifier(variableOrInterfaceName: string): string;
+/** Sanitizes a raw string to a valid TypeScript identifier, for use when generating type and variable names. */
+export declare function sanitizeName(name: string, removeWhitespace?: boolean, prefixReservedKeywords?: boolean): string;
+/** Sanitizes a property name for use in a TypeScript interface, without prefixing reserved keywords. */
+export declare function sanitizePropertyName(name: string): string;
+/** Returns a unique sanitized name, appending a numeric suffix to avoid collisions with existing names. */
+export declare function getSanitizedUniqueName(existingNames: string[], desiredName: string): string;
+/** Normalizes a type name containing generic bracket syntax into a form suitable as a TypeScript identifier. */
+export declare function normalizeGenericTypeName(typeName: string): string;
+/**
+ * Extracts a clean identifier from a potentially schema-qualified resource name,
+ * for use in generated TypeScript identifiers.
+ *
+ * Handles bracket-qualified names used by SQL, Oracle, and other tabular connectors
+ * (e.g. `[dbo].[TableName]` or `[OWNER].[TABLE_NAME]`), as well as plain names.
+ * Always takes the last segment after the final dot, strips brackets, then sanitizes.
+ */
+export declare function sanitizeTabularResourceName(name: string): string;
+/** Returns the data source name accessor for the given model's service class. */
+export declare function getServiceName(modelName: string): string;
+/** Applies well-known casing fixes to property names before they are emitted into generated types. */
+export declare function normalizePropertyName(propertyName: string): string;
+/** Converts a kebab-case string to camelCase (e.g., `common-models` → `commonModels`). */
+export declare function kebabToCamelCase(name: string): string;
+/** Wraps a property name in quotes when it cannot appear as a bare TypeScript identifier. */
+export declare function formatPropertyName(propName: string): string;
+/** Returns true if a property name can be used without quotes in a TypeScript type definition. */
+export declare function isValidPropertyName(propName: string): boolean;
+//# sourceMappingURL=nameUtils.d.ts.map

package/dist/shared/nameUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameUtils.d.ts","sourceRoot":"","sources":["../../src/shared/nameUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkEH,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,uBAAuB,EAAE,MAAM,UAOvE;AAED,gHAAgH;AAChH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,gBAAgB,GAAE,OAAc,EAChC,sBAAsB,GAAE,OAAc,GACrC,MAAM,CA8BR;AAED,wGAAwG;AACxG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,2GAA2G;AAC3G,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAsB3F;AAED,gHAAgH;AAChH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI7D"}

package/dist/shared/nameUtils.js

@@ -0,0 +1,180 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+// TypeScript reserved keywords and built-in types
+const RESERVED_KEYWORDS = new Set([
+    'break',
+    'case',
+    'catch',
+    'class',
+    'const',
+    'continue',
+    'debugger',
+    'default',
+    'delete',
+    'do',
+    'else',
+    'enum',
+    'export',
+    'extends',
+    'false',
+    'finally',
+    'for',
+    'function',
+    'if',
+    'import',
+    'in',
+    'instanceof',
+    'new',
+    'null',
+    'return',
+    'super',
+    'switch',
+    'this',
+    'throw',
+    'true',
+    'try',
+    'typeof',
+    'var',
+    'void',
+    'while',
+    'with',
+    'as',
+    'implements',
+    'interface',
+    'let',
+    'package',
+    'private',
+    'protected',
+    'public',
+    'static',
+    'yield',
+    'any',
+    'boolean',
+    'constructor',
+    'declare',
+    'get',
+    'module',
+    'require',
+    'number',
+    'set',
+    'string',
+    'symbol',
+    'type',
+    'from',
+    'of',
+]);
+/** Converts an arbitrary string to a safe TypeScript identifier for use in generated code. */
+export function convertToValidIdentifier(variableOrInterfaceName) {
+    if (variableOrInterfaceName.indexOf('@odata') > -1) {
+        // this an odata property, we can skip processing it further and return immediately, but just return a quoted version of it
+        return `"${variableOrInterfaceName}"`;
+    }
+    return sanitizeName(variableOrInterfaceName, false);
+}
+/** Sanitizes a raw string to a valid TypeScript identifier, for use when generating type and variable names. */
+export function sanitizeName(name, removeWhitespace = true, prefixReservedKeywords = true) {
+    const originalName = name;
+    // Remove any leading or trailing whitespace
+    name = name.trim();
+    if (!name) {
+        throw new Error('Invalid identifier: empty string');
+    }
+    if (removeWhitespace) {
+        name = name.replace(/\s/g, '');
+    }
+    // Remove any characters that are not alphanumeric or underscores
+    name = name.replace(/[^a-zA-Z0-9_$]/g, '_');
+    // Ensure the name does not start with a number
+    if (/^\d/.test(name)) {
+        name = `_${name}`;
+    }
+    // Ensure the name is not empty or all underscores
+    if (name.length === 0 || /^_+$/.test(name)) {
+        throw new Error(`Failed to sanitize string ${originalName}`);
+    }
+    if (prefixReservedKeywords && RESERVED_KEYWORDS.has(name)) {
+        name = `_${name}`;
+    }
+    return name;
+}
+/** Sanitizes a property name for use in a TypeScript interface, without prefixing reserved keywords. */
+export function sanitizePropertyName(name) {
+    if (name.indexOf('@odata') > -1) {
+        return `"${name}"`;
+    }
+    return sanitizeName(name, false, false);
+}
+/** Returns a unique sanitized name, appending a numeric suffix to avoid collisions with existing names. */
+export function getSanitizedUniqueName(existingNames, desiredName) {
+    // Sanitize the base name
+    desiredName = sanitizeName(desiredName);
+    const nameSet = new Set(existingNames);
+    if (!nameSet.has(desiredName)) {
+        return desiredName.toLowerCase();
+    }
+    let maxSuffix = 0;
+    // Non-literal regex shoud be safe here since baseName is sanitized
+    // and should not contain any special characters that could lead to regex injection.
+    const regex = new RegExp(`^${desiredName}_(\\d+)$`);
+    for (const name of existingNames) {
+        const match = name.match(regex);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxSuffix) {
+                maxSuffix = num;
+            }
+        }
+    }
+    return `${desiredName}_${maxSuffix + 1}`.toLowerCase();
+}
+/** Normalizes a type name containing generic bracket syntax into a form suitable as a TypeScript identifier. */
+export function normalizeGenericTypeName(typeName) {
+    return typeName.replace(/\[/g, '_').replace(/\]/g, '');
+}
+/**
+ * Extracts a clean identifier from a potentially schema-qualified resource name,
+ * for use in generated TypeScript identifiers.
+ *
+ * Handles bracket-qualified names used by SQL, Oracle, and other tabular connectors
+ * (e.g. `[dbo].[TableName]` or `[OWNER].[TABLE_NAME]`), as well as plain names.
+ * Always takes the last segment after the final dot, strips brackets, then sanitizes.
+ */
+export function sanitizeTabularResourceName(name) {
+    const result = name.trim().replace(/\[|\]/g, '');
+    const match = result.match(/\.?([^.]*)$/);
+    if (match) {
+        return sanitizeName(match[1]);
+    }
+    return sanitizeName(result);
+}
+/** Returns the data source name accessor for the given model's service class. */
+export function getServiceName(modelName) {
+    if (!modelName || !modelName.trim()) {
+        throw new Error('Model name cannot be null or empty.');
+    }
+    return `${modelName}Service.dataSourceName`;
+}
+/** Applies well-known casing fixes to property names before they are emitted into generated types. */
+export function normalizePropertyName(propertyName) {
+    return propertyName.toLowerCase() === 'resultsets' ? 'ResultSets' : propertyName;
+}
+/** Converts a kebab-case string to camelCase (e.g., `common-models` → `commonModels`). */
+export function kebabToCamelCase(name) {
+    return name.replace(/-+(.)/g, (_, c) => c.toUpperCase()).replace(/-+$/, '');
+}
+/** Wraps a property name in quotes when it cannot appear as a bare TypeScript identifier. */
+export function formatPropertyName(propName) {
+    // Skip if already quoted
+    if (propName.startsWith('"') && propName.endsWith('"')) {
+        return propName;
+    }
+    return isValidPropertyName(propName) ? propName : `"${propName}"`;
+}
+/** Returns true if a property name can be used without quotes in a TypeScript type definition. */
+export function isValidPropertyName(propName) {
+    // A valid property name must start with a letter, underscore, or dollar sign
+    // and can only contain letters, numbers, underscores, or dollar signs
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(propName);
+}
+//# sourceMappingURL=nameUtils.js.map

package/dist/shared/nameUtils.js.map

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

package/dist/shared/project.d.ts

@@ -0,0 +1,22 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * The types of files that can be generated by codegen. Each project can have up to one of each.
+ */
+export type FileIdentifier = 'model' | 'service' | 'commonModel' | 'index';
+export interface ICodegenProject {
+    /** Create a file at the given path with the given content. */
+    createFile(identifier: FileIdentifier, filePath: string, content: string): Promise<unknown>;
+    /** Commit any uncommitted files to the filesystem */
+    commit(): Promise<void>;
+    /** Join path segments using the underlying path convention. */
+    join(...paths: string[]): string;
+    /** Returns true if a directory exists at the given path. */
+    directoryExists(path: string): Promise<boolean>;
+    /** Returns true if a file exists at the given path. */
+    fileExists(path: string): Promise<boolean>;
+    /** Returns the names of all source files directly inside the given directory. */
+    getSourceFilesInDirectory(path: string): Promise<string[]>;
+}
+//# sourceMappingURL=project.d.ts.map

package/dist/shared/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/shared/project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5F,qDAAqD;IACrD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,+DAA+D;IAC/D,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC,4DAA4D;IAC5D,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,uDAAuD;IACvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,iFAAiF;IACjF,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC5D"}

package/dist/shared/project.js

@@ -0,0 +1,5 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=project.js.map

package/dist/shared/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/shared/project.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/shared/schemaUtils.d.ts

@@ -0,0 +1,32 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { JsonObject } from '../types.js';
+/**
+ * Type guard for plain JSON objects. Used widely for safe property access
+ * on `unknown` schema values before codegen processing begins.
+ */
+export declare function isJsonObject(value: unknown): value is JsonObject;
+/** Retrieves the properties map from a schema definition for iteration during code generation. */
+export declare function getPropertiesNode(definition: JsonObject): JsonObject;
+/** Returns the set of required property names from a schema, used to determine optionality in generated types. */
+export declare function getRequiredFields(definition: JsonObject): Set<string>;
+/** Converts a JSON Schema type to the TypeScript type used in generated interfaces. */
+export declare function mapJsonTypeToTypeScript(jsonType?: string): string;
+/** Resolves a JSON Schema `$ref` to the TypeScript type name it refers to. */
+export declare function extractReferencedType(refValue: string): string;
+/** Returns the schema's `name` field, which identifies the data source or connector. */
+export declare function getNameNode(schema: unknown): string;
+/** Returns true if a schema property has enumerable values (a non-empty `enum` array). */
+export declare function hasEnumValues(propValue: JsonObject): boolean;
+/** Produces the TypeScript identifier used for the type alias generated from an optionset property. */
+export declare function generateOptionsetEnumName(modelName: string, propName: string): string;
+/** Formats an enum value as a TypeScript string literal for use in union types. */
+export declare function formatEnumLabel(label: unknown): string;
+/** Returns true if the schema comes from a SharePoint data source (has a `referencedEntities` property). */
+export declare function isSharepointSchema(root: unknown): boolean;
+/** Returns true if a SharePoint schema property is a choice or multi-choice column. */
+export declare function isSharepointChoiceColumn(propNode: unknown): boolean;
+/** Extracts the items node from a standard tabular or SharePoint schema. Throws if the structure is invalid. */
+export declare function getTabularItemsFromSchema(schema: unknown): JsonObject;
+//# sourceMappingURL=schemaUtils.d.ts.map

package/dist/shared/schemaUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaUtils.d.ts","sourceRoot":"","sources":["../../src/shared/schemaUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAGhE;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAKpE;AAED,kHAAkH;AAClH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAKrE;AAED,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAcjE;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CASnD;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED,uGAAuG;AACvG,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYtD;AAED,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAcnE;AAED,gHAAgH;AAChH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CASrE"}

package/dist/shared/schemaUtils.js

@@ -0,0 +1,110 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { convertToValidIdentifier, normalizeGenericTypeName } from './nameUtils.js';
+/**
+ * Type guard for plain JSON objects. Used widely for safe property access
+ * on `unknown` schema values before codegen processing begins.
+ */
+export function isJsonObject(value) {
+    // Conclusive because 'object' type from JSON.parse() cannot have Symbol keys, or be undefined, functions, Dates, RegExp, Map/Set, or Classes
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Retrieves the properties map from a schema definition for iteration during code generation. */
+export function getPropertiesNode(definition) {
+    if (!('properties' in definition) || !isJsonObject(definition.properties)) {
+        throw new Error("The definition does not contain a valid 'properties' node.");
+    }
+    return definition.properties;
+}
+/** Returns the set of required property names from a schema, used to determine optionality in generated types. */
+export function getRequiredFields(definition) {
+    if ('required' in definition && Array.isArray(definition.required)) {
+        return new Set(definition.required.map((r) => String(r)));
+    }
+    return new Set();
+}
+/** Converts a JSON Schema type to the TypeScript type used in generated interfaces. */
+export function mapJsonTypeToTypeScript(jsonType) {
+    switch (jsonType) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'object':
+            return 'Record<string, unknown>';
+        default:
+            return 'unknown';
+    }
+}
+/** Resolves a JSON Schema `$ref` to the TypeScript type name it refers to. */
+export function extractReferencedType(refValue) {
+    const parts = refValue.split('/');
+    const raw = normalizeGenericTypeName(parts[parts.length - 1] ?? '');
+    return convertToValidIdentifier(raw);
+}
+/** Returns the schema's `name` field, which identifies the data source or connector. */
+export function getNameNode(schema) {
+    if (isJsonObject(schema)) {
+        const name = schema.name;
+        if (typeof name !== 'string' || !name.trim()) {
+            throw new Error("No 'name' node found in schema");
+        }
+        return name.trim();
+    }
+    throw new Error('Schema must be a JSON object to extract name');
+}
+/** Returns true if a schema property has enumerable values (a non-empty `enum` array). */
+export function hasEnumValues(propValue) {
+    return Array.isArray(propValue.enum) && propValue.enum.length > 0;
+}
+/** Produces the TypeScript identifier used for the type alias generated from an optionset property. */
+export function generateOptionsetEnumName(modelName, propName) {
+    return convertToValidIdentifier(`${modelName}${propName}`);
+}
+/** Formats an enum value as a TypeScript string literal for use in union types. */
+export function formatEnumLabel(label) {
+    if (label === null || label === undefined) {
+        return "''";
+    }
+    // Non-string enum values (e.g. boolean true/false, numbers) appear in some connector schemas
+    if (typeof label !== 'string') {
+        return `'${String(label).replace(/'/g, "\\'")}'`;
+    }
+    if (label.trim() === '') {
+        return "''";
+    }
+    return `'${label.replace(/'/g, "\\'")}'`;
+}
+/** Returns true if the schema comes from a SharePoint data source (has a `referencedEntities` property). */
+export function isSharepointSchema(root) {
+    return (isJsonObject(root) && !!root.referencedEntities && typeof root.referencedEntities === 'object');
+}
+/** Returns true if a SharePoint schema property is a choice or multi-choice column. */
+export function isSharepointChoiceColumn(propNode) {
+    try {
+        if (isJsonObject(propNode) &&
+            isJsonObject(propNode['x-ms-capabilities']) &&
+            isJsonObject(propNode['x-ms-capabilities']['x-ms-sp']) &&
+            propNode['x-ms-capabilities']['x-ms-sp'].IsChoice === true) {
+            return true;
+        }
+    }
+    catch {
+        // Ignore errors and return false so we fall back to default behavior
+    }
+    return false;
+}
+/** Extracts the items node from a standard tabular or SharePoint schema. Throws if the structure is invalid. */
+export function getTabularItemsFromSchema(schema) {
+    if (!isJsonObject(schema) || !isJsonObject(schema.schema) || !isJsonObject(schema.schema.items)) {
+        const name = isJsonObject(schema) && typeof schema.name === 'string' ? schema.name : 'unknown';
+        const items = schema?.schema?.items;
+        throw new Error(`Schema '${name}': expected schema.schema.items to be an object, got ${typeof items}`);
+    }
+    return schema.schema.items;
+}
+//# sourceMappingURL=schemaUtils.js.map

package/dist/shared/schemaUtils.js.map

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

package/dist/shared/sqlStoredProcUtils.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/** Returns true if the schema represents a SQL stored procedure (has a `procedureresultschema` object). */
+export declare function isSqlStoredProcedure(root: unknown): boolean;
+/**
+ * Returns the API key used to identify a stored procedure in datasourcesinfo.
+ * Strips brackets and the schema prefix: `[dbo].[testProc]` → `testProc`.
+ */
+export declare function getSqlStoredProcApiKey(name: string): string;
+//# sourceMappingURL=sqlStoredProcUtils.d.ts.map

package/dist/shared/sqlStoredProcUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlStoredProcUtils.d.ts","sourceRoot":"","sources":["../../src/shared/sqlStoredProcUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAM3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3D"}