@rippling/rippling-sdk 0.2.0-alpha.85 → 0.2.0-alpha.86

package/core/platform/custom-objects/definition.d.mts

@@ -0,0 +1,147 @@
+import type { CustomObjectCategoryDefinition } from "./category.mjs";
+import type { AnyCustomObjectDefinition, AnyFieldDefinition, CategoryApiName, CustomObjectApiName, CustomObjectDefinition, FieldDefinitions, FieldNames, LogicalCategoryName, LogicalCustomFieldName, LogicalCustomObjectName, NameFieldDefinition, SectionDefinitions } from "./types.mjs";
+/**
+ * Internal input shape accepted by {@link defineCustomObject} before normalization.
+ *
+ * @typeParam TObjectName - Logical custom-object name for the definition.
+ * @typeParam TCategoryName - Logical category name associated with the object.
+ * @typeParam TSections - Section map available to field definitions.
+ * @typeParam TFields - Field map keyed by logical custom-field names.
+ * @typeParam TNameField - Optional name-field behavior supplied by the caller.
+ */
+type CategoryInput<TCategoryName extends string> = LogicalCategoryName<TCategoryName> | CustomObjectCategoryDefinition<LogicalCategoryName<TCategoryName>>;
+/**
+ * Internal input shape accepted by {@link defineCustomObject} before normalization.
+ *
+ * @typeParam TObjectName - Logical custom-object name for the definition.
+ * @typeParam TCategoryName - Logical category name associated with the object.
+ * @typeParam TSections - Section map available to field definitions.
+ * @typeParam TFields - Field map keyed by logical custom-field names.
+ * @typeParam TNameField - Optional name-field behavior supplied by the caller.
+ */
+interface CustomObjectDefinitionInput<TObjectName extends string, TCategoryName extends string, TSections extends SectionDefinitions, TFields extends FieldDefinitions, TNameField extends NameFieldDefinition> {
+    readonly name: LogicalCustomObjectName<TObjectName>;
+    readonly displayName: string;
+    readonly pluralLabel?: string;
+    readonly category: CategoryInput<TCategoryName>;
+    readonly ownerRole?: string;
+    readonly enableHistory?: boolean;
+    readonly description: string;
+    readonly icon?: {
+        readonly emoji?: string | null;
+        readonly ripplingIcon?: string | null;
+        readonly s3Bucket?: string;
+        readonly s3Key?: string;
+    };
+    readonly nameField?: TNameField;
+    readonly sections?: TSections;
+    readonly fields: ValidateFieldMap<TFields>;
+}
+/**
+ * Rejects extension objects that try to redefine keys already present on the base definition.
+ *
+ * @typeParam TExisting - Existing key set on the base definition.
+ * @typeParam TAdded - Proposed extension object.
+ */
+type NoOverlappingKeys<TExisting extends object, TAdded extends object> = Extract<keyof TExisting, keyof TAdded> extends never ? TAdded : never;
+/**
+ * Converts a logical field map into a version whose keys must all satisfy the
+ * logical custom-field name contract.
+ *
+ * @typeParam TFields - Candidate logical field map supplied by callers.
+ */
+type ValidateFieldMap<TFields extends FieldDefinitions> = {
+    readonly [K in keyof TFields]: K extends string ? LogicalCustomFieldName<K> extends never ? never : TFields[K] : never;
+};
+/**
+ * Appends the platform-required `__c` suffix to a logical custom-object name.
+ *
+ * @param name - Logical unsuffixed custom-object name.
+ * @returns Wire-level custom-object API name with the required `__c` suffix.
+ * @typeParam TObjectName - Logical custom-object name to compile.
+ */
+export declare function toCustomObjectApiName<TObjectName extends string>(name: LogicalCustomObjectName<TObjectName>): CustomObjectApiName<TObjectName>;
+/**
+ * Appends the platform-required `__c` suffix to a logical custom-field name.
+ *
+ * @param name - Logical unsuffixed custom-field name.
+ * @returns Wire-level custom-field API name with the required `__c` suffix.
+ * @typeParam TFieldName - Logical custom-field name to compile.
+ */
+export declare function toCustomFieldApiName<TFieldName extends string>(name: LogicalCustomFieldName<TFieldName>): `${TFieldName}__c`;
+/**
+ * Appends the platform-required `__c` suffix to a logical category name.
+ *
+ * @param name - Logical unsuffixed category name.
+ * @returns Wire-level category API name with the required `__c` suffix.
+ * @typeParam TCategoryName - Logical category name to compile.
+ */
+export declare function toCustomCategoryApiName<TCategoryName extends string>(name: LogicalCategoryName<TCategoryName>): CategoryApiName<TCategoryName>;
+/**
+ * Defines an immutable, strongly typed custom-object schema.
+ *
+ * Callers author only logical snake_case names. The returned value includes the
+ * derived wire-level api names so downstream tooling can emit valid manifest
+ * payloads without requiring authors to know about the `__c` suffix contract.
+ *
+ * @typeParam TObjectName - Logical custom-object name for the definition.
+ * @typeParam TCategoryName - Logical category name associated with the object.
+ * @typeParam TSections - Section map available to field definitions.
+ * @typeParam TFields - Field map keyed by logical custom-field names.
+ * @param definition - Author-facing typed schema definition to normalize, validate, and freeze.
+ * @returns Immutable normalized custom-object definition with compiled field and object API names.
+ * @typeParam TNameField - Name-field behavior for the object.
+ */
+export declare function defineCustomObject<TObjectName extends string, TCategoryName extends string, TSections extends SectionDefinitions = {}, TFields extends FieldDefinitions = FieldDefinitions, TNameField extends NameFieldDefinition = {
+    kind: 'text';
+}>(definition: CustomObjectDefinitionInput<TObjectName, TCategoryName, TSections, TFields, TNameField>): Readonly<CustomObjectDefinition<LogicalCustomObjectName<TObjectName>, LogicalCategoryName<TCategoryName>, TSections, TFields, TNameField>>;
+/**
+ * Extends an existing object definition without losing type information.
+ *
+ * This helper is useful when a platform package wants to publish a base schema
+ * and another package wants to add fields or sections in a type-safe way.
+ *
+ * @typeParam TBase - Existing object definition being extended.
+ * @typeParam TAddedSections - New section definitions merged into the base object.
+ * @param base - Existing typed object definition to extend.
+ * @param extension - Additional metadata, sections, and fields to merge into the base definition.
+ * @returns New immutable custom-object definition preserving the combined type information.
+ * @typeParam TAddedFields - New field definitions merged into the base object.
+ */
+export declare function extendCustomObject<TBase extends AnyCustomObjectDefinition, TAddedSections extends SectionDefinitions = {}, TAddedFields extends FieldDefinitions = {}>(base: TBase, extension: {
+    readonly displayName?: string;
+    readonly pluralLabel?: string;
+    readonly ownerRole?: string;
+    readonly enableHistory?: boolean;
+    readonly description?: string;
+    readonly icon?: TBase['icon'];
+    readonly sections?: NoOverlappingKeys<TBase['sections'], TAddedSections>;
+    readonly fields?: NoOverlappingKeys<TBase['fields'], ValidateFieldMap<TAddedFields>>;
+}): Readonly<CustomObjectDefinition<TBase['name'], TBase['category'], TBase['sections'] & TAddedSections, Omit<TBase['fields'], never> & TAddedFields, TBase['nameField']>>;
+/**
+ * Returns the logical custom field names defined on an object.
+ *
+ * @param definition - Object definition whose logical field names should be returned.
+ * @returns Frozen array of logical field names from the definition.
+ * @typeParam TDefinition - Object definition whose field names should be returned.
+ */
+export declare function fieldNames<TDefinition extends AnyCustomObjectDefinition>(definition: TDefinition): ReadonlyArray<FieldNames<TDefinition>>;
+/**
+ * Retrieves a field definition by logical field name with precise typing.
+ *
+ * @param definition - Object definition that owns the field.
+ * @param fieldName - Logical field name to retrieve.
+ * @returns Precisely typed field definition for the requested logical field name.
+ * @typeParam TDefinition - Object definition that owns the field.
+ * @typeParam TFieldName - Logical field name being retrieved.
+ */
+export declare function getFieldDefinition<TDefinition extends AnyCustomObjectDefinition, TFieldName extends FieldNames<TDefinition>>(definition: TDefinition, fieldName: TFieldName): TDefinition['fields'][TFieldName];
+/**
+ * Returns whether one typed field definition is writable by record create/update helpers.
+ *
+ * @param field - Typed field definition to inspect.
+ * @returns Whether the field may be written by callers.
+ */
+export declare function isWritableField(field: AnyFieldDefinition): boolean;
+export {};
+//# sourceMappingURL=definition.d.mts.map

package/core/platform/custom-objects/definition.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.mts","sourceRoot":"","sources":["../../../src/core/platform/custom-objects/definition.ts"],"names":[],"mappings":"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"}

package/core/platform/custom-objects/definition.d.ts

@@ -0,0 +1,147 @@
+import type { CustomObjectCategoryDefinition } from "./category.js";
+import type { AnyCustomObjectDefinition, AnyFieldDefinition, CategoryApiName, CustomObjectApiName, CustomObjectDefinition, FieldDefinitions, FieldNames, LogicalCategoryName, LogicalCustomFieldName, LogicalCustomObjectName, NameFieldDefinition, SectionDefinitions } from "./types.js";
+/**
+ * Internal input shape accepted by {@link defineCustomObject} before normalization.
+ *
+ * @typeParam TObjectName - Logical custom-object name for the definition.
+ * @typeParam TCategoryName - Logical category name associated with the object.
+ * @typeParam TSections - Section map available to field definitions.
+ * @typeParam TFields - Field map keyed by logical custom-field names.
+ * @typeParam TNameField - Optional name-field behavior supplied by the caller.
+ */
+type CategoryInput<TCategoryName extends string> = LogicalCategoryName<TCategoryName> | CustomObjectCategoryDefinition<LogicalCategoryName<TCategoryName>>;
+/**
+ * Internal input shape accepted by {@link defineCustomObject} before normalization.
+ *
+ * @typeParam TObjectName - Logical custom-object name for the definition.
+ * @typeParam TCategoryName - Logical category name associated with the object.
+ * @typeParam TSections - Section map available to field definitions.
+ * @typeParam TFields - Field map keyed by logical custom-field names.
+ * @typeParam TNameField - Optional name-field behavior supplied by the caller.
+ */
+interface CustomObjectDefinitionInput<TObjectName extends string, TCategoryName extends string, TSections extends SectionDefinitions, TFields extends FieldDefinitions, TNameField extends NameFieldDefinition> {
+    readonly name: LogicalCustomObjectName<TObjectName>;
+    readonly displayName: string;
+    readonly pluralLabel?: string;
+    readonly category: CategoryInput<TCategoryName>;
+    readonly ownerRole?: string;
+    readonly enableHistory?: boolean;
+    readonly description: string;
+    readonly icon?: {
+        readonly emoji?: string | null;
+        readonly ripplingIcon?: string | null;
+        readonly s3Bucket?: string;
+        readonly s3Key?: string;
+    };
+    readonly nameField?: TNameField;
+    readonly sections?: TSections;
+    readonly fields: ValidateFieldMap<TFields>;
+}
+/**
+ * Rejects extension objects that try to redefine keys already present on the base definition.
+ *
+ * @typeParam TExisting - Existing key set on the base definition.
+ * @typeParam TAdded - Proposed extension object.
+ */
+type NoOverlappingKeys<TExisting extends object, TAdded extends object> = Extract<keyof TExisting, keyof TAdded> extends never ? TAdded : never;
+/**
+ * Converts a logical field map into a version whose keys must all satisfy the
+ * logical custom-field name contract.
+ *
+ * @typeParam TFields - Candidate logical field map supplied by callers.
+ */
+type ValidateFieldMap<TFields extends FieldDefinitions> = {
+    readonly [K in keyof TFields]: K extends string ? LogicalCustomFieldName<K> extends never ? never : TFields[K] : never;
+};
+/**
+ * Appends the platform-required `__c` suffix to a logical custom-object name.
+ *
+ * @param name - Logical unsuffixed custom-object name.
+ * @returns Wire-level custom-object API name with the required `__c` suffix.
+ * @typeParam TObjectName - Logical custom-object name to compile.
+ */
+export declare function toCustomObjectApiName<TObjectName extends string>(name: LogicalCustomObjectName<TObjectName>): CustomObjectApiName<TObjectName>;
+/**
+ * Appends the platform-required `__c` suffix to a logical custom-field name.
+ *
+ * @param name - Logical unsuffixed custom-field name.
+ * @returns Wire-level custom-field API name with the required `__c` suffix.
+ * @typeParam TFieldName - Logical custom-field name to compile.
+ */
+export declare function toCustomFieldApiName<TFieldName extends string>(name: LogicalCustomFieldName<TFieldName>): `${TFieldName}__c`;
+/**
+ * Appends the platform-required `__c` suffix to a logical category name.
+ *
+ * @param name - Logical unsuffixed category name.
+ * @returns Wire-level category API name with the required `__c` suffix.
+ * @typeParam TCategoryName - Logical category name to compile.
+ */
+export declare function toCustomCategoryApiName<TCategoryName extends string>(name: LogicalCategoryName<TCategoryName>): CategoryApiName<TCategoryName>;
+/**
+ * Defines an immutable, strongly typed custom-object schema.
+ *
+ * Callers author only logical snake_case names. The returned value includes the
+ * derived wire-level api names so downstream tooling can emit valid manifest
+ * payloads without requiring authors to know about the `__c` suffix contract.
+ *
+ * @typeParam TObjectName - Logical custom-object name for the definition.
+ * @typeParam TCategoryName - Logical category name associated with the object.
+ * @typeParam TSections - Section map available to field definitions.
+ * @typeParam TFields - Field map keyed by logical custom-field names.
+ * @param definition - Author-facing typed schema definition to normalize, validate, and freeze.
+ * @returns Immutable normalized custom-object definition with compiled field and object API names.
+ * @typeParam TNameField - Name-field behavior for the object.
+ */
+export declare function defineCustomObject<TObjectName extends string, TCategoryName extends string, TSections extends SectionDefinitions = {}, TFields extends FieldDefinitions = FieldDefinitions, TNameField extends NameFieldDefinition = {
+    kind: 'text';
+}>(definition: CustomObjectDefinitionInput<TObjectName, TCategoryName, TSections, TFields, TNameField>): Readonly<CustomObjectDefinition<LogicalCustomObjectName<TObjectName>, LogicalCategoryName<TCategoryName>, TSections, TFields, TNameField>>;
+/**
+ * Extends an existing object definition without losing type information.
+ *
+ * This helper is useful when a platform package wants to publish a base schema
+ * and another package wants to add fields or sections in a type-safe way.
+ *
+ * @typeParam TBase - Existing object definition being extended.
+ * @typeParam TAddedSections - New section definitions merged into the base object.
+ * @param base - Existing typed object definition to extend.
+ * @param extension - Additional metadata, sections, and fields to merge into the base definition.
+ * @returns New immutable custom-object definition preserving the combined type information.
+ * @typeParam TAddedFields - New field definitions merged into the base object.
+ */
+export declare function extendCustomObject<TBase extends AnyCustomObjectDefinition, TAddedSections extends SectionDefinitions = {}, TAddedFields extends FieldDefinitions = {}>(base: TBase, extension: {
+    readonly displayName?: string;
+    readonly pluralLabel?: string;
+    readonly ownerRole?: string;
+    readonly enableHistory?: boolean;
+    readonly description?: string;
+    readonly icon?: TBase['icon'];
+    readonly sections?: NoOverlappingKeys<TBase['sections'], TAddedSections>;
+    readonly fields?: NoOverlappingKeys<TBase['fields'], ValidateFieldMap<TAddedFields>>;
+}): Readonly<CustomObjectDefinition<TBase['name'], TBase['category'], TBase['sections'] & TAddedSections, Omit<TBase['fields'], never> & TAddedFields, TBase['nameField']>>;
+/**
+ * Returns the logical custom field names defined on an object.
+ *
+ * @param definition - Object definition whose logical field names should be returned.
+ * @returns Frozen array of logical field names from the definition.
+ * @typeParam TDefinition - Object definition whose field names should be returned.
+ */
+export declare function fieldNames<TDefinition extends AnyCustomObjectDefinition>(definition: TDefinition): ReadonlyArray<FieldNames<TDefinition>>;
+/**
+ * Retrieves a field definition by logical field name with precise typing.
+ *
+ * @param definition - Object definition that owns the field.
+ * @param fieldName - Logical field name to retrieve.
+ * @returns Precisely typed field definition for the requested logical field name.
+ * @typeParam TDefinition - Object definition that owns the field.
+ * @typeParam TFieldName - Logical field name being retrieved.
+ */
+export declare function getFieldDefinition<TDefinition extends AnyCustomObjectDefinition, TFieldName extends FieldNames<TDefinition>>(definition: TDefinition, fieldName: TFieldName): TDefinition['fields'][TFieldName];
+/**
+ * Returns whether one typed field definition is writable by record create/update helpers.
+ *
+ * @param field - Typed field definition to inspect.
+ * @returns Whether the field may be written by callers.
+ */
+export declare function isWritableField(field: AnyFieldDefinition): boolean;
+export {};
+//# sourceMappingURL=definition.d.ts.map

package/core/platform/custom-objects/definition.d.ts.map

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

package/core/platform/custom-objects/definition.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCustomObjectApiName = toCustomObjectApiName;
+exports.toCustomFieldApiName = toCustomFieldApiName;
+exports.toCustomCategoryApiName = toCustomCategoryApiName;
+exports.defineCustomObject = defineCustomObject;
+exports.extendCustomObject = extendCustomObject;
+exports.fieldNames = fieldNames;
+exports.getFieldDefinition = getFieldDefinition;
+exports.isWritableField = isWritableField;
+const validation_1 = require("./validation.js");
+/**
+ * Recursively freezes author-authored schema definitions.
+ *
+ * The schema layer is intended to act like durable configuration data rather
+ * than mutable runtime state, so this helper aggressively removes mutation as a
+ * failure mode after validation succeeds.
+ *
+ * @typeParam T - Value being frozen.
+ */
+/**
+ * Deeply freezes a schema fragment after validation succeeds.
+ *
+ * @param value - Value to recursively freeze in place.
+ * @returns The same value, now deeply frozen where applicable.
+ * @typeParam T - Value being frozen.
+ */
+function deepFreeze(value) {
+    if (value == null || typeof value !== 'object')
+        return value;
+    for (const child of Object.values(value)) {
+        deepFreeze(child);
+    }
+    return Object.freeze(value);
+}
+/**
+ * Appends the platform-required `__c` suffix to a logical custom-object name.
+ *
+ * @param name - Logical unsuffixed custom-object name.
+ * @returns Wire-level custom-object API name with the required `__c` suffix.
+ * @typeParam TObjectName - Logical custom-object name to compile.
+ */
+function toCustomObjectApiName(name) {
+    return `${name}__c`;
+}
+/**
+ * Appends the platform-required `__c` suffix to a logical custom-field name.
+ *
+ * @param name - Logical unsuffixed custom-field name.
+ * @returns Wire-level custom-field API name with the required `__c` suffix.
+ * @typeParam TFieldName - Logical custom-field name to compile.
+ */
+function toCustomFieldApiName(name) {
+    return `${name}__c`;
+}
+/**
+ * Appends the platform-required `__c` suffix to a logical category name.
+ *
+ * @param name - Logical unsuffixed category name.
+ * @returns Wire-level category API name with the required `__c` suffix.
+ * @typeParam TCategoryName - Logical category name to compile.
+ */
+function toCustomCategoryApiName(name) {
+    return `${name}__c`;
+}
+/**
+ * Defines an immutable, strongly typed custom-object schema.
+ *
+ * Callers author only logical snake_case names. The returned value includes the
+ * derived wire-level api names so downstream tooling can emit valid manifest
+ * payloads without requiring authors to know about the `__c` suffix contract.
+ *
+ * @typeParam TObjectName - Logical custom-object name for the definition.
+ * @typeParam TCategoryName - Logical category name associated with the object.
+ * @typeParam TSections - Section map available to field definitions.
+ * @typeParam TFields - Field map keyed by logical custom-field names.
+ * @param definition - Author-facing typed schema definition to normalize, validate, and freeze.
+ * @returns Immutable normalized custom-object definition with compiled field and object API names.
+ * @typeParam TNameField - Name-field behavior for the object.
+ */
+function defineCustomObject(definition) {
+    (0, validation_1.validateLogicalCustomObjectName)(definition.name);
+    const categoryDefinition = typeof definition.category === 'string' ? undefined : definition.category;
+    const categoryName = typeof definition.category === 'string' ? definition.category : definition.category.name;
+    const categoryApiName = typeof definition.category === 'string' ?
+        toCustomCategoryApiName(definition.category)
+        : definition.category.apiName;
+    (0, validation_1.validateLogicalCategoryName)(categoryName);
+    const resolvedFields = Object.fromEntries(Object.entries(definition.fields).map(([logicalName, field]) => {
+        (0, validation_1.validateLogicalCustomFieldName)(logicalName);
+        return [
+            logicalName,
+            {
+                ...field,
+                logicalName,
+                apiName: toCustomFieldApiName(logicalName),
+            },
+        ];
+    }));
+    const normalized = {
+        name: definition.name,
+        apiName: toCustomObjectApiName(definition.name),
+        displayName: definition.displayName,
+        ...(definition.pluralLabel != null ? { pluralLabel: definition.pluralLabel } : {}),
+        category: categoryName,
+        ...(categoryDefinition != null ? { categoryDefinition } : {}),
+        ...(definition.ownerRole != null ? { ownerRole: definition.ownerRole } : {}),
+        ...(definition.enableHistory != null ? { enableHistory: definition.enableHistory } : {}),
+        categoryApiName: categoryApiName,
+        description: definition.description,
+        ...(definition.icon != null ? { icon: definition.icon } : {}),
+        nameField: (definition.nameField ?? { kind: 'text' }),
+        sections: (definition.sections ?? {}),
+        fields: resolvedFields,
+    };
+    const issues = (0, validation_1.validateCustomObjectDefinition)(normalized);
+    if (issues.length > 0) {
+        throw new Error(`Invalid custom object definition for "${definition.name}":\n` +
+            issues.map((issue) => `- ${issue.path}: ${issue.message}`).join('\n'));
+    }
+    return deepFreeze(normalized);
+}
+/**
+ * Extends an existing object definition without losing type information.
+ *
+ * This helper is useful when a platform package wants to publish a base schema
+ * and another package wants to add fields or sections in a type-safe way.
+ *
+ * @typeParam TBase - Existing object definition being extended.
+ * @typeParam TAddedSections - New section definitions merged into the base object.
+ * @param base - Existing typed object definition to extend.
+ * @param extension - Additional metadata, sections, and fields to merge into the base definition.
+ * @returns New immutable custom-object definition preserving the combined type information.
+ * @typeParam TAddedFields - New field definitions merged into the base object.
+ */
+function extendCustomObject(base, extension) {
+    const mergedSections = {
+        ...base.sections,
+        ...(extension.sections ?? {}),
+    };
+    const mergedFields = Object.fromEntries(Object.entries({ ...base.fields, ...(extension.fields ?? {}) }).map(([logicalName, field]) => [
+        logicalName,
+        {
+            ...field,
+            logicalName,
+            apiName: toCustomFieldApiName(logicalName),
+        },
+    ]));
+    return defineCustomObject({
+        name: base.name,
+        displayName: extension.displayName ?? base.displayName,
+        ...(extension.pluralLabel != null || base.pluralLabel != null ?
+            { pluralLabel: extension.pluralLabel ?? base.pluralLabel }
+            : {}),
+        ...(extension.ownerRole != null || base.ownerRole != null ?
+            { ownerRole: extension.ownerRole ?? base.ownerRole }
+            : {}),
+        ...(extension.enableHistory != null || base.enableHistory != null ?
+            { enableHistory: extension.enableHistory ?? base.enableHistory }
+            : {}),
+        category: base.categoryDefinition ?? base.category,
+        description: extension.description ?? base.description,
+        ...((extension.icon ?? base.icon) != null ? { icon: extension.icon ?? base.icon } : {}),
+        nameField: base.nameField,
+        sections: mergedSections,
+        fields: mergedFields,
+    });
+}
+/**
+ * Returns the logical custom field names defined on an object.
+ *
+ * @param definition - Object definition whose logical field names should be returned.
+ * @returns Frozen array of logical field names from the definition.
+ * @typeParam TDefinition - Object definition whose field names should be returned.
+ */
+function fieldNames(definition) {
+    return Object.freeze(Object.keys(definition.fields));
+}
+/**
+ * Retrieves a field definition by logical field name with precise typing.
+ *
+ * @param definition - Object definition that owns the field.
+ * @param fieldName - Logical field name to retrieve.
+ * @returns Precisely typed field definition for the requested logical field name.
+ * @typeParam TDefinition - Object definition that owns the field.
+ * @typeParam TFieldName - Logical field name being retrieved.
+ */
+function getFieldDefinition(definition, fieldName) {
+    return definition.fields[fieldName];
+}
+/**
+ * Returns whether one typed field definition is writable by record create/update helpers.
+ *
+ * @param field - Typed field definition to inspect.
+ * @returns Whether the field may be written by callers.
+ */
+function isWritableField(field) {
+    return field.writable;
+}
+//# sourceMappingURL=definition.js.map

package/core/platform/custom-objects/definition.js.map

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