@open-captable-protocol/canton 0.2.178 → 0.2.180

package/dist/functions/OpenCapTable/stockPlan/createStockPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createStockPlan.d.ts","sourceRoot":"","sources":["../../../../src/functions/OpenCapTable/stockPlan/createStockPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,gBAAgB,CAAC;AA2BlF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAyBzG"}
+{"version":3,"file":"createStockPlan.d.ts","sourceRoot":"","sources":["../../../../src/functions/OpenCapTable/stockPlan/createStockPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,gBAAgB,CAAC;AAyBlF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CA0BzG"}

package/dist/functions/OpenCapTable/stockPlan/createStockPlan.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stockPlanDataToDaml = stockPlanDataToDaml;
 const errors_1 = require("../../../errors");
+const deprecatedFieldNormalization_1 = require("../../../utils/deprecatedFieldNormalization");
 const typeConversions_1 = require("../../../utils/typeConversions");
 function cancellationBehaviorToDaml(b) {
     if (!b)
@@ -26,11 +27,9 @@ function stockPlanDataToDaml(d) {
             receivedValue: d.id,
         });
     }
-    // Handle deprecated stock_class_id → stock_class_ids
-    // Cast to allow for deprecated field and potentially missing stock_class_ids (when only deprecated field is provided)
-    const data = d;
-    const currentIds = data.stock_class_ids ?? [];
-    const stockClassIds = currentIds.length > 0 ? currentIds : data.stock_class_id ? [data.stock_class_id] : [];
+    // Normalize deprecated stock_class_id → stock_class_ids using centralized helper
+    // Cast to allow for deprecated field which may be present in older OCF data
+    const { stock_class_ids } = (0, deprecatedFieldNormalization_1.normalizeDeprecatedStockPlanFields)(d, 'stockPlan.create');
     return {
         id: d.id,
         plan_name: d.plan_name,
@@ -38,7 +37,7 @@ function stockPlanDataToDaml(d) {
         stockholder_approval_date: d.stockholder_approval_date ? (0, typeConversions_1.dateStringToDAMLTime)(d.stockholder_approval_date) : null,
         initial_shares_reserved: typeof d.initial_shares_reserved === 'number' ? d.initial_shares_reserved.toString() : d.initial_shares_reserved,
         default_cancellation_behavior: cancellationBehaviorToDaml(d.default_cancellation_behavior),
-        stock_class_ids: stockClassIds,
+        stock_class_ids,
         comments: (0, typeConversions_1.cleanComments)(d.comments),
     };
 }

package/dist/functions/OpenCapTable/stockPlan/createStockPlan.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStockPlan.js","sourceRoot":"","sources":["../../../../src/functions/OpenCapTable/stockPlan/createStockPlan.ts"],"names":[],"mappings":";;AA6BA,kDAyBC;AArDD,4CAAqD;AAErD,oEAAqF;AAErF,SAAS,0BAA0B,CACjC,CAA4C;IAE5C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,qBAAqB,CAAC;QAC/B,KAAK,gBAAgB;YACnB,OAAO,2BAA2B,CAAC;QACrC,KAAK,uBAAuB;YAC1B,OAAO,iCAAiC,CAAC;QAC3C,KAAK,2BAA2B;YAC9B,OAAO,qCAAqC,CAAC;QAC/C;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAQD,SAAgB,mBAAmB,CAAC,CAAe;IACjD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,IAAI,2BAAkB,CAAC,cAAc,EAAE,oCAAoC,EAAE;YACjF,YAAY,EAAE,QAAQ;YACtB,aAAa,EAAE,CAAC,CAAC,EAAE;SACpB,CAAC,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,sHAAsH;IACtH,MAAM,IAAI,GAAG,CAAgC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5G,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,mBAAmB,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAA,sCAAoB,EAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/F,yBAAyB,EAAE,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAA,sCAAoB,EAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,IAAI;QACjH,uBAAuB,EACrB,OAAO,CAAC,CAAC,uBAAuB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;QAClH,6BAA6B,EAAE,0BAA0B,CAAC,CAAC,CAAC,6BAA6B,CAAC;QAC1F,eAAe,EAAE,aAAa;QAC9B,QAAQ,EAAE,IAAA,+BAAa,EAAC,CAAC,CAAC,QAAQ,CAAC;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createStockPlan.js","sourceRoot":"","sources":["../../../../src/functions/OpenCapTable/stockPlan/createStockPlan.ts"],"names":[],"mappings":";;AA2BA,kDA0BC;AApDD,4CAAqD;AAErD,8FAGqD;AACrD,oEAAqF;AAErF,SAAS,0BAA0B,CACjC,CAA4C;IAE5C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,qBAAqB,CAAC;QAC/B,KAAK,gBAAgB;YACnB,OAAO,2BAA2B,CAAC;QACrC,KAAK,uBAAuB;YAC1B,OAAO,iCAAiC,CAAC;QAC3C,KAAK,2BAA2B;YAC9B,OAAO,qCAAqC,CAAC;QAC/C;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,SAAgB,mBAAmB,CAAC,CAAe;IACjD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,IAAI,2BAAkB,CAAC,cAAc,EAAE,oCAAoC,EAAE;YACjF,YAAY,EAAE,QAAQ;YACtB,aAAa,EAAE,CAAC,CAAC,EAAE;SACpB,CAAC,CAAC;IACL,CAAC;IAED,iFAAiF;IACjF,4EAA4E;IAC5E,MAAM,EAAE,eAAe,EAAE,GAAG,IAAA,iEAAkC,EAC5D,CAAqC,EACrC,kBAAkB,CACnB,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,mBAAmB,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAA,sCAAoB,EAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/F,yBAAyB,EAAE,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAA,sCAAoB,EAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,IAAI;QACjH,uBAAuB,EACrB,OAAO,CAAC,CAAC,uBAAuB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;QAClH,6BAA6B,EAAE,0BAA0B,CAAC,CAAC,CAAC,6BAA6B,CAAC;QAC1F,eAAe;QACf,QAAQ,EAAE,IAAA,+BAAa,EAAC,CAAC,CAAC,QAAQ,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/utils/deprecatedFieldNormalization.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Utilities for normalizing deprecated OCF fields to their current equivalents.
+ *
+ * OCF schema evolves over time, and some fields are deprecated in favor of new ones.
+ * These utilities provide type-safe normalization and verification helpers.
+ *
+ * @example
+ *   ```typescript
+ *   import { normalizeSingularToArray, normalizeDeprecatedStockPlanFields } from './deprecatedFieldNormalization';
+ *
+ *   // Generic singular → array normalization
+ *   const stockClassIds = normalizeSingularToArray({
+ *     singularValue: data.stock_class_id,
+ *     arrayValue: data.stock_class_ids,
+ *   });
+ *
+ *   // Stock plan specific helper
+ *   const normalized = normalizeDeprecatedStockPlanFields(inputData);
+ *   ```
+ */
+/**
+ * Configuration for deprecation warnings.
+ * Can be customized for testing or production environments.
+ */
+export interface DeprecationWarningConfig {
+    /** Whether to emit console warnings for deprecated field usage (default: true in development) */
+    enabled: boolean;
+    /** Custom warning handler (default: console.warn) */
+    handler?: (message: string, details: DeprecationDetails) => void;
+}
+/**
+ * Details about a deprecated field usage.
+ */
+export interface DeprecationDetails {
+    /** Name of the deprecated field */
+    deprecatedField: string;
+    /** Name of the replacement field */
+    replacementField: string;
+    /** The deprecated value that was provided */
+    deprecatedValue: unknown;
+    /** Context about where the deprecation occurred */
+    context?: string;
+}
+/**
+ * Global deprecation warning configuration.
+ * Can be modified for testing or to customize warning behavior.
+ */
+export declare const deprecationWarningConfig: DeprecationWarningConfig;
+/**
+ * Emit a deprecation warning.
+ *
+ * @param details - Details about the deprecated field usage
+ */
+export declare function emitDeprecationWarning(details: DeprecationDetails): void;
+/**
+ * Parameters for normalizing a singular deprecated field to an array field.
+ */
+export interface SingularToArrayParams<T> {
+    /** The deprecated singular value (may be undefined) */
+    singularValue: T | undefined;
+    /** The current array value (may be undefined or empty) */
+    arrayValue: T[] | undefined;
+    /** Name of the deprecated field (for warnings) */
+    deprecatedFieldName?: string;
+    /** Name of the replacement field (for warnings) */
+    replacementFieldName?: string;
+    /** Context for the warning message */
+    context?: string;
+}
+/**
+ * Normalize a deprecated singular field to an array field.
+ *
+ * When both singular and array values are provided, the array takes precedence.
+ * If the array is empty/undefined but singular has a value, wraps it in an array.
+ *
+ * @param params - Parameters for the normalization
+ * @returns The normalized array value (empty array if both inputs are empty/undefined)
+ *
+ * @example
+ *   ```typescript
+ *   // Only deprecated field provided
+ *   normalizeSingularToArray({
+ *     singularValue: 'class-1',
+ *     arrayValue: undefined,
+ *   }); // Returns ['class-1']
+ *
+ *   // Both provided - array takes precedence
+ *   normalizeSingularToArray({
+ *     singularValue: 'class-1',
+ *     arrayValue: ['class-2', 'class-3'],
+ *   }); // Returns ['class-2', 'class-3']
+ *
+ *   // Neither provided
+ *   normalizeSingularToArray({
+ *     singularValue: undefined,
+ *     arrayValue: undefined,
+ *   }); // Returns []
+ *   ```
+ */
+export declare function normalizeSingularToArray<T>(params: SingularToArrayParams<T>): T[];
+/**
+ * Input type that may contain deprecated stock_class_id field.
+ * This matches OCF data that may come from older schemas.
+ *
+ * Note: Fields can be null (not just undefined) when parsing JSON data from external sources.
+ */
+export interface StockPlanDataWithDeprecatedField {
+    /** The current array field for stock class associations */
+    stock_class_ids?: string[] | null;
+    /** @deprecated Use stock_class_ids instead. Deprecated field from older OCF versions. */
+    stock_class_id?: string | null;
+}
+/**
+ * Result of normalizing deprecated stock plan fields.
+ */
+export interface NormalizedStockPlanFields {
+    /** Normalized array of stock class IDs */
+    stock_class_ids: string[];
+    /** Whether a deprecated field was used */
+    usedDeprecatedField: boolean;
+}
+/**
+ * Normalize deprecated stock plan fields.
+ *
+ * Handles the OCF deprecation of `stock_class_id` (singular) → `stock_class_ids` (array).
+ *
+ * @param data - Stock plan data that may contain deprecated fields
+ * @param context - Optional context for deprecation warnings (e.g., "stockPlan.create")
+ * @returns Object containing normalized stock_class_ids and deprecation usage flag
+ *
+ * @example
+ *   ```typescript
+ *   // Old format (deprecated)
+ *   const result = normalizeDeprecatedStockPlanFields({
+ *     stock_class_id: 'sc-1',
+ *   });
+ *   // Returns { stock_class_ids: ['sc-1'], usedDeprecatedField: true }
+ *
+ *   // New format
+ *   const result = normalizeDeprecatedStockPlanFields({
+ *     stock_class_ids: ['sc-1', 'sc-2'],
+ *   });
+ *   // Returns { stock_class_ids: ['sc-1', 'sc-2'], usedDeprecatedField: false }
+ *   ```
+ */
+export declare function normalizeDeprecatedStockPlanFields(data: StockPlanDataWithDeprecatedField, context?: string): NormalizedStockPlanFields;
+/**
+ * Result of checking for deprecated field usage.
+ */
+export interface DeprecatedFieldUsageResult {
+    /** Whether any deprecated fields were detected */
+    hasDeprecatedFields: boolean;
+    /** List of deprecated fields that were used */
+    deprecatedFieldsUsed: string[];
+}
+/**
+ * Check stock plan data for deprecated field usage without modifying the data.
+ *
+ * @param data - Stock plan data to check
+ * @returns Result indicating whether deprecated fields were used
+ *
+ * @example
+ *   ```typescript
+ *   const result = checkStockPlanDeprecatedFieldUsage({
+ *     stock_class_id: 'sc-1', // deprecated
+ *   });
+ *   // Returns { hasDeprecatedFields: true, deprecatedFieldsUsed: ['stock_class_id'] }
+ *   ```
+ */
+export declare function checkStockPlanDeprecatedFieldUsage(data: StockPlanDataWithDeprecatedField): DeprecatedFieldUsageResult;
+/**
+ * Configuration for a deprecated field mapping.
+ */
+export interface DeprecatedFieldMapping {
+    /** The deprecated field name */
+    deprecatedField: string;
+    /** The replacement field name */
+    replacementField: string;
+    /** The type of deprecation (singular_to_array, renamed, etc.) */
+    deprecationType: 'singular_to_array' | 'renamed' | 'removed';
+}
+/**
+ * Known OCF deprecated field mappings.
+ * Add new deprecations here as they are discovered.
+ */
+export declare const OCF_DEPRECATED_FIELDS: Record<string, DeprecatedFieldMapping[]>;
+/**
+ * Get the list of deprecated field mappings for an OCF object type.
+ *
+ * @param objectType - The OCF object type name (e.g., 'StockPlan')
+ * @returns Array of deprecated field mappings for the object type
+ */
+export declare function getDeprecatedFieldMappings(objectType: string): DeprecatedFieldMapping[];
+/**
+ * Check if a specific field is deprecated for an OCF object type.
+ *
+ * @param objectType - The OCF object type name
+ * @param fieldName - The field name to check
+ * @returns The deprecation mapping if the field is deprecated, undefined otherwise
+ */
+export declare function getFieldDeprecation(objectType: string, fieldName: string): DeprecatedFieldMapping | undefined;
+/**
+ * Check an object for any deprecated field usage based on known deprecations.
+ *
+ * @param objectType - The OCF object type name
+ * @param data - The object data to check
+ * @returns Result indicating which deprecated fields were used
+ *
+ * @example
+ *   ```typescript
+ *   const result = checkDeprecatedFields('StockPlan', {
+ *     stock_class_id: 'sc-1', // deprecated
+ *     plan_name: 'Equity Plan',
+ *   });
+ *   // Returns { hasDeprecatedFields: true, deprecatedFieldsUsed: ['stock_class_id'] }
+ *   ```
+ */
+export declare function checkDeprecatedFields(objectType: string, data: Record<string, unknown>): DeprecatedFieldUsageResult;
+//# sourceMappingURL=deprecatedFieldNormalization.d.ts.map

package/dist/utils/deprecatedFieldNormalization.d.ts.map

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

package/dist/utils/deprecatedFieldNormalization.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Utilities for normalizing deprecated OCF fields to their current equivalents.
+ *
+ * OCF schema evolves over time, and some fields are deprecated in favor of new ones.
+ * These utilities provide type-safe normalization and verification helpers.
+ *
+ * @example
+ *   ```typescript
+ *   import { normalizeSingularToArray, normalizeDeprecatedStockPlanFields } from './deprecatedFieldNormalization';
+ *
+ *   // Generic singular → array normalization
+ *   const stockClassIds = normalizeSingularToArray({
+ *     singularValue: data.stock_class_id,
+ *     arrayValue: data.stock_class_ids,
+ *   });
+ *
+ *   // Stock plan specific helper
+ *   const normalized = normalizeDeprecatedStockPlanFields(inputData);
+ *   ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OCF_DEPRECATED_FIELDS = exports.deprecationWarningConfig = void 0;
+exports.emitDeprecationWarning = emitDeprecationWarning;
+exports.normalizeSingularToArray = normalizeSingularToArray;
+exports.normalizeDeprecatedStockPlanFields = normalizeDeprecatedStockPlanFields;
+exports.checkStockPlanDeprecatedFieldUsage = checkStockPlanDeprecatedFieldUsage;
+exports.getDeprecatedFieldMappings = getDeprecatedFieldMappings;
+exports.getFieldDeprecation = getFieldDeprecation;
+exports.checkDeprecatedFields = checkDeprecatedFields;
+/**
+ * Global deprecation warning configuration.
+ * Can be modified for testing or to customize warning behavior.
+ */
+exports.deprecationWarningConfig = {
+    enabled: process.env.NODE_ENV !== 'test',
+    handler: undefined,
+};
+/**
+ * Emit a deprecation warning.
+ *
+ * @param details - Details about the deprecated field usage
+ */
+function emitDeprecationWarning(details) {
+    if (!exports.deprecationWarningConfig.enabled) {
+        return;
+    }
+    const message = `[OCF Deprecation] Field '${details.deprecatedField}' is deprecated. ` +
+        `Use '${details.replacementField}' instead.${details.context ? ` Context: ${details.context}` : ''}`;
+    if (exports.deprecationWarningConfig.handler) {
+        exports.deprecationWarningConfig.handler(message, details);
+    }
+    else {
+        // eslint-disable-next-line no-console -- Intentional deprecation warning to help developers migrate to current API
+        console.warn(message);
+    }
+}
+/**
+ * Normalize a deprecated singular field to an array field.
+ *
+ * When both singular and array values are provided, the array takes precedence.
+ * If the array is empty/undefined but singular has a value, wraps it in an array.
+ *
+ * @param params - Parameters for the normalization
+ * @returns The normalized array value (empty array if both inputs are empty/undefined)
+ *
+ * @example
+ *   ```typescript
+ *   // Only deprecated field provided
+ *   normalizeSingularToArray({
+ *     singularValue: 'class-1',
+ *     arrayValue: undefined,
+ *   }); // Returns ['class-1']
+ *
+ *   // Both provided - array takes precedence
+ *   normalizeSingularToArray({
+ *     singularValue: 'class-1',
+ *     arrayValue: ['class-2', 'class-3'],
+ *   }); // Returns ['class-2', 'class-3']
+ *
+ *   // Neither provided
+ *   normalizeSingularToArray({
+ *     singularValue: undefined,
+ *     arrayValue: undefined,
+ *   }); // Returns []
+ *   ```
+ */
+function normalizeSingularToArray(params) {
+    const { singularValue, arrayValue, deprecatedFieldName, replacementFieldName, context } = params;
+    // If array has values, use it (ignoring deprecated singular)
+    if (Array.isArray(arrayValue) && arrayValue.length > 0) {
+        return arrayValue;
+    }
+    // If singular value exists, convert to array and emit warning
+    // Also exclude empty strings to match original truthy-check behavior
+    if (singularValue !== undefined && singularValue !== null && singularValue !== '') {
+        if (deprecatedFieldName && replacementFieldName) {
+            emitDeprecationWarning({
+                deprecatedField: deprecatedFieldName,
+                replacementField: replacementFieldName,
+                deprecatedValue: singularValue,
+                context,
+            });
+        }
+        return [singularValue];
+    }
+    // Neither provided - return empty array
+    return [];
+}
+/**
+ * Normalize deprecated stock plan fields.
+ *
+ * Handles the OCF deprecation of `stock_class_id` (singular) → `stock_class_ids` (array).
+ *
+ * @param data - Stock plan data that may contain deprecated fields
+ * @param context - Optional context for deprecation warnings (e.g., "stockPlan.create")
+ * @returns Object containing normalized stock_class_ids and deprecation usage flag
+ *
+ * @example
+ *   ```typescript
+ *   // Old format (deprecated)
+ *   const result = normalizeDeprecatedStockPlanFields({
+ *     stock_class_id: 'sc-1',
+ *   });
+ *   // Returns { stock_class_ids: ['sc-1'], usedDeprecatedField: true }
+ *
+ *   // New format
+ *   const result = normalizeDeprecatedStockPlanFields({
+ *     stock_class_ids: ['sc-1', 'sc-2'],
+ *   });
+ *   // Returns { stock_class_ids: ['sc-1', 'sc-2'], usedDeprecatedField: false }
+ *   ```
+ */
+function normalizeDeprecatedStockPlanFields(data, context) {
+    // Also exclude empty strings to match original truthy-check behavior
+    const hasDeprecatedField = data.stock_class_id !== undefined && data.stock_class_id !== null && data.stock_class_id !== '';
+    const hasCurrentField = Array.isArray(data.stock_class_ids) && data.stock_class_ids.length > 0;
+    // Only count as using deprecated field if deprecated is present and current is not
+    const usedDeprecatedField = hasDeprecatedField && !hasCurrentField;
+    // Normalize null to undefined for the generic function, then filter results
+    const singularValue = data.stock_class_id ?? undefined;
+    const arrayValue = data.stock_class_ids ?? undefined;
+    const stock_class_ids = normalizeSingularToArray({
+        singularValue,
+        arrayValue,
+        deprecatedFieldName: 'stock_class_id',
+        replacementFieldName: 'stock_class_ids',
+        context: context ?? 'StockPlan',
+    });
+    return {
+        stock_class_ids,
+        usedDeprecatedField,
+    };
+}
+/**
+ * Check stock plan data for deprecated field usage without modifying the data.
+ *
+ * @param data - Stock plan data to check
+ * @returns Result indicating whether deprecated fields were used
+ *
+ * @example
+ *   ```typescript
+ *   const result = checkStockPlanDeprecatedFieldUsage({
+ *     stock_class_id: 'sc-1', // deprecated
+ *   });
+ *   // Returns { hasDeprecatedFields: true, deprecatedFieldsUsed: ['stock_class_id'] }
+ *   ```
+ */
+function checkStockPlanDeprecatedFieldUsage(data) {
+    const deprecatedFieldsUsed = [];
+    // Check for deprecated stock_class_id field (exclude empty strings to match original truthy-check behavior)
+    if (data.stock_class_id !== undefined && data.stock_class_id !== null && data.stock_class_id !== '') {
+        deprecatedFieldsUsed.push('stock_class_id');
+    }
+    return {
+        hasDeprecatedFields: deprecatedFieldsUsed.length > 0,
+        deprecatedFieldsUsed,
+    };
+}
+/**
+ * Known OCF deprecated field mappings.
+ * Add new deprecations here as they are discovered.
+ */
+exports.OCF_DEPRECATED_FIELDS = {
+    StockPlan: [
+        {
+            deprecatedField: 'stock_class_id',
+            replacementField: 'stock_class_ids',
+            deprecationType: 'singular_to_array',
+        },
+    ],
+};
+/**
+ * Get the list of deprecated field mappings for an OCF object type.
+ *
+ * @param objectType - The OCF object type name (e.g., 'StockPlan')
+ * @returns Array of deprecated field mappings for the object type
+ */
+function getDeprecatedFieldMappings(objectType) {
+    return exports.OCF_DEPRECATED_FIELDS[objectType] ?? [];
+}
+/**
+ * Check if a specific field is deprecated for an OCF object type.
+ *
+ * @param objectType - The OCF object type name
+ * @param fieldName - The field name to check
+ * @returns The deprecation mapping if the field is deprecated, undefined otherwise
+ */
+function getFieldDeprecation(objectType, fieldName) {
+    const mappings = getDeprecatedFieldMappings(objectType);
+    return mappings.find((m) => m.deprecatedField === fieldName);
+}
+/**
+ * Check an object for any deprecated field usage based on known deprecations.
+ *
+ * @param objectType - The OCF object type name
+ * @param data - The object data to check
+ * @returns Result indicating which deprecated fields were used
+ *
+ * @example
+ *   ```typescript
+ *   const result = checkDeprecatedFields('StockPlan', {
+ *     stock_class_id: 'sc-1', // deprecated
+ *     plan_name: 'Equity Plan',
+ *   });
+ *   // Returns { hasDeprecatedFields: true, deprecatedFieldsUsed: ['stock_class_id'] }
+ *   ```
+ */
+function checkDeprecatedFields(objectType, data) {
+    const mappings = getDeprecatedFieldMappings(objectType);
+    const deprecatedFieldsUsed = [];
+    for (const mapping of mappings) {
+        const value = data[mapping.deprecatedField];
+        // Also exclude empty strings to match original truthy-check behavior
+        if (value !== undefined && value !== null && value !== '') {
+            deprecatedFieldsUsed.push(mapping.deprecatedField);
+        }
+    }
+    return {
+        hasDeprecatedFields: deprecatedFieldsUsed.length > 0,
+        deprecatedFieldsUsed,
+    };
+}
+//# sourceMappingURL=deprecatedFieldNormalization.js.map

package/dist/utils/deprecatedFieldNormalization.js.map

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

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
+export * from './deprecatedFieldNormalization';
 export * from './enumConversions';
 export * from './ocfComparison';
 export * from './ocfHelpers';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./deprecatedFieldNormalization"), exports);
 __exportStar(require("./enumConversions"), exports);
 __exportStar(require("./ocfComparison"), exports);
 __exportStar(require("./ocfHelpers"), exports);

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,kDAAgC;AAChC,+CAA6B;AAC7B,gDAA8B;AAC9B,uDAAqC;AACrC,oDAAkC;AAClC,+CAA6B;AAC7B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,oDAAkC;AAClC,kDAAgC;AAChC,+CAA6B;AAC7B,gDAA8B;AAC9B,uDAAqC;AACrC,oDAAkC;AAClC,+CAA6B;AAC7B,+CAA6B"}

package/dist/utils/ocfComparison.d.ts

@@ -6,6 +6,46 @@
  *
  * @module ocfComparison
  */
+/**
+ * Default internal fields added by the database/SDK that should be ignored during comparison.
+ * These are not part of the OCF specification.
+ */
+export declare const DEFAULT_INTERNAL_FIELDS: readonly ["__v", "_id", "_source", "issuer", "tx_hash", "createdAt", "updatedAt", "is_onchain_synced", "vestings"];
+/**
+ * Deprecated OCF fields that may differ between source and round-tripped data.
+ * These fields may be upgraded or removed during processing.
+ */
+export declare const DEFAULT_DEPRECATED_FIELDS: readonly ["option_grant_type"];
+/**
+ * Options for OCF comparison.
+ */
+export interface OcfComparisonOptions {
+    /**
+     * Fields to ignore during comparison. Defaults to empty array (compare all fields).
+     * Use DEFAULT_INTERNAL_FIELDS to ignore internal database/SDK fields.
+     */
+    ignoredFields?: readonly string[];
+    /**
+     * Deprecated fields that may differ between source and destination.
+     * Defaults to empty array (compare all fields).
+     * Use DEFAULT_DEPRECATED_FIELDS to ignore deprecated OCF fields.
+     */
+    deprecatedFields?: readonly string[];
+    /**
+     * Whether to report differences for debugging. When true, differences are logged to console.
+     * Default: false
+     */
+    reportDifferences?: boolean;
+}
+/**
+ * Result of an OCF comparison with details about any differences found.
+ */
+export interface OcfComparisonResult {
+    /** Whether the objects are semantically equal. */
+    equal: boolean;
+    /** List of paths where differences were found. */
+    differences: string[];
+}
 /**
  * Deep equality comparison for OCF objects with normalization.
  *
@@ -15,10 +55,41 @@
  * - Treats empty arrays/objects as equivalent to undefined
  * - Trims string whitespace
  * - Recursively compares nested objects
+ * - Optionally ignores internal/deprecated fields
  *
  * @param a - First OCF object
  * @param b - Second OCF object
+ * @param options - Comparison options
  * @returns True if objects are semantically equal
  */
-export declare function ocfDeepEqual(a: unknown, b: unknown): boolean;
+export declare function ocfDeepEqual(a: unknown, b: unknown, options?: OcfComparisonOptions): boolean;
+/**
+ * Compare two OCF objects and return detailed results.
+ *
+ * @param a - First OCF object (typically the source/expected value)
+ * @param b - Second OCF object (typically the result/actual value)
+ * @param options - Comparison options
+ * @returns Comparison result with equality status and list of differences
+ *
+ * @example
+ * ```typescript
+ * const result = ocfCompare(sourceFixture, readBackData, {
+ *   ignoredFields: DEFAULT_INTERNAL_FIELDS,
+ *   reportDifferences: true
+ * });
+ *
+ * if (!result.equal) {
+ *   console.log('Differences found:', result.differences);
+ * }
+ * ```
+ */
+export declare function ocfCompare(a: unknown, b: unknown, options?: OcfComparisonOptions): OcfComparisonResult;
+/**
+ * Strip internal and deprecated fields from an OCF object for cleaner comparison.
+ *
+ * @param obj - The OCF object to clean
+ * @param fieldsToRemove - Fields to remove (defaults to DEFAULT_INTERNAL_FIELDS + DEFAULT_DEPRECATED_FIELDS)
+ * @returns A new object with the specified fields removed
+ */
+export declare function stripInternalFields<T extends Record<string, unknown>>(obj: T, fieldsToRemove?: readonly string[]): Partial<T>;
 //# sourceMappingURL=ocfComparison.d.ts.map

package/dist/utils/ocfComparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ocfComparison.d.ts","sourceRoot":"","sources":["../../src/utils/ocfComparison.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8FH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA4C5D"}
+{"version":3,"file":"ocfComparison.d.ts","sourceRoot":"","sources":["../../src/utils/ocfComparison.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,oHAU1B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,yBAAyB,gCAE5B,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AA8FD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAG5F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CA4GtG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,GAAG,EAAE,CAAC,EACN,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GACjC,OAAO,CAAC,CAAC,CAAC,CA6BZ"}

package/dist/utils/ocfComparison.js

@@ -8,7 +8,32 @@
  * @module ocfComparison
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_DEPRECATED_FIELDS = exports.DEFAULT_INTERNAL_FIELDS = void 0;
 exports.ocfDeepEqual = ocfDeepEqual;
+exports.ocfCompare = ocfCompare;
+exports.stripInternalFields = stripInternalFields;
+/**
+ * Default internal fields added by the database/SDK that should be ignored during comparison.
+ * These are not part of the OCF specification.
+ */
+exports.DEFAULT_INTERNAL_FIELDS = [
+    '__v', // MongoDB version key
+    '_id', // MongoDB document ID
+    '_source', // Fixture source marker
+    'issuer', // Internal issuer reference
+    'tx_hash', // Blockchain transaction hash
+    'createdAt', // Database timestamp
+    'updatedAt', // Database timestamp
+    'is_onchain_synced', // Sync status flag
+    'vestings', // Computed vesting schedule (derived data)
+];
+/**
+ * Deprecated OCF fields that may differ between source and round-tripped data.
+ * These fields may be upgraded or removed during processing.
+ */
+exports.DEFAULT_DEPRECATED_FIELDS = [
+    'option_grant_type', // Deprecated in favor of compensation_type
+];
 /**
  * Normalize a value for OCF comparison.
  *
@@ -111,50 +136,162 @@ function isUndefinedLike(value) {
  * - Treats empty arrays/objects as equivalent to undefined
  * - Trims string whitespace
  * - Recursively compares nested objects
+ * - Optionally ignores internal/deprecated fields
  *
  * @param a - First OCF object
  * @param b - Second OCF object
+ * @param options - Comparison options
  * @returns True if objects are semantically equal
  */
-function ocfDeepEqual(a, b) {
-    // Consider empty arrays equivalent to undefined
-    if (isUndefinedLike(a) && isUndefinedLike(b))
-        return true;
-    // Handle null/undefined
-    if (a === b)
-        return true;
-    if (a == null || b == null)
-        return false;
-    // Handle different types
-    if (typeof a !== typeof b)
-        return false;
-    // Handle objects and arrays
-    if (typeof a === 'object' && typeof b === 'object') {
-        const objA = a;
-        const objB = b;
-        // Get all keys
-        const keysA = Object.keys(objA);
-        const keysB = Object.keys(objB);
-        const allKeys = Array.from(new Set([...keysA, ...keysB]));
-        // Check if all keys match
-        for (const key of allKeys) {
-            const valA = objA[key];
-            const valB = objB[key];
-            // Treat empty arrays as undefined-like and skip if both are undefined-like
-            if (isUndefinedLike(valA) && isUndefinedLike(valB))
-                continue;
-            // If one is undefined-like and the other isn't, they don't match
-            if (isUndefinedLike(valA) !== isUndefinedLike(valB))
-                return false;
-            // Recursively compare values
-            if (!ocfDeepEqual(valA, valB))
-                return false;
+function ocfDeepEqual(a, b, options) {
+    const result = ocfCompare(a, b, options);
+    return result.equal;
+}
+/**
+ * Compare two OCF objects and return detailed results.
+ *
+ * @param a - First OCF object (typically the source/expected value)
+ * @param b - Second OCF object (typically the result/actual value)
+ * @param options - Comparison options
+ * @returns Comparison result with equality status and list of differences
+ *
+ * @example
+ * ```typescript
+ * const result = ocfCompare(sourceFixture, readBackData, {
+ *   ignoredFields: DEFAULT_INTERNAL_FIELDS,
+ *   reportDifferences: true
+ * });
+ *
+ * if (!result.equal) {
+ *   console.log('Differences found:', result.differences);
+ * }
+ * ```
+ */
+function ocfCompare(a, b, options) {
+    const ignoredFields = new Set(options?.ignoredFields ?? []);
+    const deprecatedFields = new Set(options?.deprecatedFields ?? []);
+    const allIgnored = new Set([...ignoredFields, ...deprecatedFields]);
+    const reportDifferences = options?.reportDifferences ?? false;
+    const differences = [];
+    function compare(valA, valB, path) {
+        // Consider empty arrays equivalent to undefined
+        if (isUndefinedLike(valA) && isUndefinedLike(valB))
+            return true;
+        // Handle null/undefined
+        if (valA === valB)
+            return true;
+        if (valA == null || valB == null) {
+            differences.push(`${path}: ${JSON.stringify(valA)} !== ${JSON.stringify(valB)}`);
+            return false;
+        }
+        // Handle different types
+        if (typeof valA !== typeof valB) {
+            differences.push(`${path}: type mismatch (${typeof valA} vs ${typeof valB})`);
+            return false;
+        }
+        // Handle objects and arrays
+        if (typeof valA === 'object' && typeof valB === 'object') {
+            const objA = valA;
+            const objB = valB;
+            // Handle arrays
+            if (Array.isArray(valA) && Array.isArray(valB)) {
+                if (valA.length !== valB.length) {
+                    // Check if difference is just undefined-like elements
+                    const filteredA = valA.filter((v) => !isUndefinedLike(v));
+                    const filteredB = valB.filter((v) => !isUndefinedLike(v));
+                    if (filteredA.length !== filteredB.length) {
+                        differences.push(`${path}: array length mismatch (${valA.length} vs ${valB.length})`);
+                        return false;
+                    }
+                }
+                let allMatch = true;
+                const maxLen = Math.max(valA.length, valB.length);
+                for (let i = 0; i < maxLen; i++) {
+                    if (!compare(valA[i], valB[i], `${path}[${i}]`)) {
+                        allMatch = false;
+                    }
+                }
+                return allMatch;
+            }
+            // Get all keys, excluding ignored fields
+            const keysA = Object.keys(objA).filter((k) => !allIgnored.has(k));
+            const keysB = Object.keys(objB).filter((k) => !allIgnored.has(k));
+            const allKeys = Array.from(new Set([...keysA, ...keysB]));
+            let allMatch = true;
+            // Check if all keys match
+            for (const key of allKeys) {
+                const childValA = objA[key];
+                const childValB = objB[key];
+                const childPath = path ? `${path}.${key}` : key;
+                // Treat empty arrays as undefined-like and skip if both are undefined-like
+                if (isUndefinedLike(childValA) && isUndefinedLike(childValB))
+                    continue;
+                // If one is undefined-like and the other isn't, they don't match
+                if (isUndefinedLike(childValA) !== isUndefinedLike(childValB)) {
+                    differences.push(`${childPath}: one side is empty/undefined`);
+                    allMatch = false;
+                    continue;
+                }
+                // Recursively compare values
+                if (!compare(childValA, childValB, childPath)) {
+                    allMatch = false;
+                }
+            }
+            return allMatch;
+        }
+        // Handle primitive values with normalization
+        const normalizedA = normalizeOcfValue(valA);
+        const normalizedB = normalizeOcfValue(valB);
+        if (normalizedA !== normalizedB) {
+            differences.push(`${path}: ${JSON.stringify(valA)} !== ${JSON.stringify(valB)}`);
+            return false;
         }
         return true;
     }
-    // Handle primitive values with normalization
-    const normalizedA = normalizeOcfValue(a);
-    const normalizedB = normalizeOcfValue(b);
-    return normalizedA === normalizedB;
+    const equal = compare(a, b, '');
+    if (reportDifferences && differences.length > 0) {
+        // eslint-disable-next-line no-console
+        console.log('OCF comparison differences:');
+        for (const diff of differences) {
+            // eslint-disable-next-line no-console
+            console.log(`  - ${diff}`);
+        }
+    }
+    return { equal, differences };
+}
+/**
+ * Strip internal and deprecated fields from an OCF object for cleaner comparison.
+ *
+ * @param obj - The OCF object to clean
+ * @param fieldsToRemove - Fields to remove (defaults to DEFAULT_INTERNAL_FIELDS + DEFAULT_DEPRECATED_FIELDS)
+ * @returns A new object with the specified fields removed
+ */
+function stripInternalFields(obj, fieldsToRemove) {
+    const toRemove = new Set(fieldsToRemove ?? [...exports.DEFAULT_INTERNAL_FIELDS, ...exports.DEFAULT_DEPRECATED_FIELDS]);
+    // Helper to process array items (handles nested arrays recursively)
+    const processArrayItem = (item) => {
+        if (!item || typeof item !== 'object') {
+            return item;
+        }
+        if (Array.isArray(item)) {
+            return item.map(processArrayItem);
+        }
+        return stripInternalFields(item, fieldsToRemove);
+    };
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (toRemove.has(key))
+            continue;
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            result[key] = stripInternalFields(value, fieldsToRemove);
+        }
+        else if (Array.isArray(value)) {
+            result[key] = value.map(processArrayItem);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
 }
 //# sourceMappingURL=ocfComparison.js.map

package/dist/utils/ocfComparison.js.map

@@ -1 +1 @@
-{"version":3,"file":"ocfComparison.js","sourceRoot":"","sources":["../../src/utils/ocfComparison.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ocfComparison.js","sourceRoot":"","sources":["../../src/utils/ocfComparison.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAwKH,oCAGC;AAsBD,gCA4GC;AASD,kDAgCC;AApVD;;;GAGG;AACU,QAAA,uBAAuB,GAAG;IACrC,KAAK,EAAE,sBAAsB;IAC7B,KAAK,EAAE,sBAAsB;IAC7B,SAAS,EAAE,wBAAwB;IACnC,QAAQ,EAAE,4BAA4B;IACtC,SAAS,EAAE,8BAA8B;IACzC,WAAW,EAAE,qBAAqB;IAClC,WAAW,EAAE,qBAAqB;IAClC,mBAAmB,EAAE,mBAAmB;IACxC,UAAU,EAAE,2CAA2C;CAC/C,CAAC;AAEX;;;GAGG;AACU,QAAA,yBAAyB,GAAG;IACvC,mBAAmB,EAAE,2CAA2C;CACxD,CAAC;AAoCX;;;;;;;;;;GAUG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,qEAAqE;QACrE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAE7B,0CAA0C;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,uDAAuD;YACvD,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,oBAAoB;IACpB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvD,2CAA2C;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAElE,6EAA6E;IAC7E,MAAM,gBAAgB,GAAG,CAAC,CAAU,EAAW,EAAE;QAC/C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,MAAM,GAAG,GAAG,CAA4B,CAAC;QACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAC1C,uBAAuB;QACvB,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACjE,MAAM,aAAa,GAAG,CAAC,CAAU,EAAU,EAAE;YAC3C,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC;YACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,8EAA8E;IAC9E,gGAAgG;IAChG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACxD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gFAAgF;IAChF,gFAAgF;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,gBAAgB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY,CAAC,CAAU,EAAE,CAAU,EAAE,OAA8B;IACjF,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,UAAU,CAAC,CAAU,EAAE,CAAU,EAAE,OAA8B;IAC/E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC;IACpE,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,KAAK,CAAC;IAE9D,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,SAAS,OAAO,CAAC,IAAa,EAAE,IAAa,EAAE,IAAY;QACzD,gDAAgD;QAChD,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAEhE,wBAAwB;QACxB,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,yBAAyB;QACzB,IAAI,OAAO,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,oBAAoB,OAAO,IAAI,OAAO,OAAO,IAAI,GAAG,CAAC,CAAC;YAC9E,OAAO,KAAK,CAAC;QACf,CAAC;QAED,4BAA4B;QAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,GAAG,IAA+B,CAAC;YAC7C,MAAM,IAAI,GAAG,IAA+B,CAAC;YAE7C,gBAAgB;YAChB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChC,sDAAsD;oBACtD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;wBAC1C,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,4BAA4B,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;wBACtF,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;gBAED,IAAI,QAAQ,GAAG,IAAI,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBAChD,QAAQ,GAAG,KAAK,CAAC;oBACnB,CAAC;gBACH,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,yCAAyC;YACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAE1D,IAAI,QAAQ,GAAG,IAAI,CAAC;YAEpB,0BAA0B;YAC1B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBAEhD,2EAA2E;gBAC3E,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC,SAAS,CAAC;oBAAE,SAAS;gBAEvE,iEAAiE;gBACjE,IAAI,eAAe,CAAC,SAAS,CAAC,KAAK,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC9D,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,+BAA+B,CAAC,CAAC;oBAC9D,QAAQ,GAAG,KAAK,CAAC;oBACjB,SAAS;gBACX,CAAC;gBAED,6BAA6B;gBAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;oBAC9C,QAAQ,GAAG,KAAK,CAAC;gBACnB,CAAC;YACH,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,6CAA6C;QAC7C,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhC,IAAI,iBAAiB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,GAAM,EACN,cAAkC;IAElC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,+BAAuB,EAAE,GAAG,iCAAyB,CAAC,CAAC,CAAC;IAEvG,oEAAoE;IACpE,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAW,EAAE;QAClD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,mBAAmB,CAAC,IAA+B,EAAE,cAAc,CAAC,CAAC;IAC9E,CAAC,CAAC;IAEF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAEhC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,KAAgC,EAAE,cAAc,CAAC,CAAC;QACtF,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAoB,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-captable-protocol/canton",
-  "version": "0.2.178",
+  "version": "0.2.180",
   "description": "A TypeScript SDK for interacting with the Open CapTable Protocol (OCP) Factory contract on Canton blockchain",
   "license": "MIT",
   "main": "dist/index.js",