@acorex-platform/module-location-management-client 0.0.15 → 0.0.21

package/contracts/entities/location-type/location-type.entity.js

@@ -1,237 +0,0 @@
-import { AXPWidgetsCatalog } from '@acorex-platform/framework-shared/core';
-import { createAllQueryView, entityMasterCrudActions, entityMasterRecordActions } from '@acorex-platform/framework-shared/entity';
-import { RootConfig } from '../../root-config';
-export async function locationTypeFactory() {
-    const i18n = RootConfig.config.i18n;
-    const entityDef = {
-        module: RootConfig.module.name,
-        name: RootConfig.entities.locationType.name,
-        title: RootConfig.entities.locationType.title,
-        formats: {
-            individual: RootConfig.entities.locationType.title,
-            plural: RootConfig.entities.locationType.titlePlural,
-            searchResult: {
-                title: '{{ title }}',
-                description: '{{ description }}',
-            },
-        },
-        groups: [
-            {
-                id: 'basic-info',
-                title: '@general:terms.interface.basic-info',
-            },
-            {
-                id: 'appearance',
-                title: '@general:terms.interface.appearance',
-            },
-            {
-                id: 'settings',
-                title: '@general:terms.interface.settings',
-            },
-        ],
-        plugins: [
-            { name: 'archive' },
-            { name: 'color' },
-            { name: 'icon' },
-        ],
-        properties: [
-            {
-                name: 'title',
-                title: '@general:terms.common.title',
-                groupId: 'basic-info',
-                options: {
-                    sort: {
-                        enabled: true,
-                    },
-                    filter: {
-                        advance: {
-                            enabled: true,
-                        },
-                        inline: {
-                            enabled: true,
-                        },
-                    },
-                },
-                schema: {
-                    dataType: 'string',
-                    interface: {
-                        type: AXPWidgetsCatalog.text,
-                        options: {
-                            placeholder: 'Enter location type name',
-                        },
-                    },
-                },
-                validations: [
-                    {
-                        rule: 'required',
-                    },
-                ],
-            },
-            {
-                name: 'description',
-                title: '@general:terms.common.description',
-                groupId: 'basic-info',
-                options: {
-                    filter: {
-                        advance: {
-                            enabled: true,
-                        },
-                    },
-                },
-                schema: {
-                    dataType: 'string',
-                    interface: {
-                        type: AXPWidgetsCatalog.largeText,
-                        options: {
-                            rows: 3,
-                        },
-                    },
-                },
-            },
-        ],
-        columns: [{ name: 'title' }, { name: 'description' }],
-        interfaces: {
-            master: {
-                create: {
-                    sections: [
-                        {
-                            id: 'basic-info',
-                        },
-                        {
-                            id: 'appearance',
-                        },
-                        {
-                            id: 'settings',
-                        },
-                    ],
-                    properties: [
-                        {
-                            name: 'title',
-                            layout: {
-                                positions: {
-                                    sm: {
-                                        colSpan: 12,
-                                    },
-                                },
-                            },
-                        },
-                        {
-                            name: 'description',
-                            layout: {
-                                positions: {
-                                    sm: {
-                                        colSpan: 12,
-                                    },
-                                },
-                            },
-                        },
-                    ],
-                },
-                update: {
-                    sections: [
-                        {
-                            id: 'basic-info',
-                        },
-                        {
-                            id: 'appearance',
-                        },
-                        {
-                            id: 'settings',
-                        },
-                    ],
-                    properties: [
-                        {
-                            name: 'title',
-                            layout: {
-                                positions: {
-                                    sm: {
-                                        colSpan: 12,
-                                    },
-                                },
-                            },
-                        },
-                        {
-                            name: 'description',
-                            layout: {
-                                positions: {
-                                    sm: {
-                                        colSpan: 12,
-                                    },
-                                },
-                            },
-                        },
-                    ],
-                },
-                single: {
-                    title: '{{title}}',
-                    sections: [
-                        {
-                            id: 'basic-info',
-                            layout: {
-                                positions: {
-                                    lg: {
-                                        colSpan: 12,
-                                    },
-                                },
-                            },
-                        },
-                        {
-                            id: 'appearance',
-                            layout: {
-                                positions: {
-                                    lg: {
-                                        colSpan: 12,
-                                    },
-                                },
-                            },
-                        },
-                        {
-                            id: 'settings',
-                            layout: {
-                                positions: {
-                                    lg: {
-                                        colSpan: 12,
-                                    },
-                                },
-                            },
-                        },
-                    ],
-                    properties: [
-                        {
-                            name: 'title',
-                            layout: {
-                                positions: {
-                                    lg: {
-                                        colSpan: 12,
-                                        order: 1,
-                                    },
-                                },
-                            },
-                        },
-                        {
-                            name: 'description',
-                            layout: {
-                                positions: {
-                                    lg: {
-                                        colSpan: 12,
-                                        order: 2,
-                                    },
-                                },
-                            },
-                        },
-                    ],
-                    actions: [...entityMasterRecordActions()],
-                },
-                list: {
-                    actions: [...entityMasterCrudActions()],
-                    views: [
-                        createAllQueryView({
-                            sorts: [{ name: 'title', dir: 'asc' }],
-                        }),
-                    ],
-                },
-            },
-        },
-    };
-    return entityDef;
-}

package/contracts/entities/location-type/location-type.types.d.ts

@@ -1,8 +0,0 @@
-import { AXPEntityModel } from '@acorex-platform/framework-shared/entity';
-export interface AXMLocationManagementLocationTypeEntityModel extends AXPEntityModel<string> {
-    title: string;
-    description?: string;
-    icon?: string;
-    color?: string;
-    isActive: boolean;
-}

package/contracts/entities/location-type/location-type.types.js

@@ -1 +0,0 @@
-export {};

package/contracts/features.keys.d.ts

@@ -1 +0,0 @@
-export declare const AXMLocationManagementFeatureKeys: {};

package/contracts/features.keys.js

@@ -1,2 +0,0 @@
-// Management feature removed - module name is used directly as feature key
-export const AXMLocationManagementFeatureKeys = {};

package/contracts/index.d.ts

@@ -1,8 +0,0 @@
-export * from './datasource.keys';
-export * from './features.keys';
-export * from './location-assignment.actions';
-export * from './location-assignment.utils';
-export * from './menu.keys';
-export * from './permission.keys';
-export * from './root-config';
-export * from './entities';

package/contracts/index.js

@@ -1,10 +0,0 @@
-//#region ---- Contracts barrel ----
-export * from './datasource.keys';
-export * from './features.keys';
-export * from './location-assignment.actions';
-export * from './location-assignment.utils';
-export * from './menu.keys';
-export * from './permission.keys';
-export * from './root-config';
-//#endregion
-export * from './entities';

package/contracts/location-assignment.actions.d.ts

@@ -1,8 +0,0 @@
-import { AXPEntityAction } from '@acorex-platform/framework-shared/entity';
-/** Read-only assignments list on Location detail (no create/update/delete). */
-export declare function locationAssignmentReadOnlyRelatedActions(): AXPEntityAction[];
-/**
- * Actions for LocationAssignment when shown from Party/Customer/Supplier.
- * Create menu: assign existing location or create new location with assignee prefilled.
- */
-export declare function locationAssignmentDetailsCrudActionsForPartyContext(_partyIdContextPath?: string): AXPEntityAction[];

package/contracts/location-assignment.actions.js

@@ -1,73 +0,0 @@
-import { AXPSystemActionType } from '@acorex-platform/framework-shared/core';
-import { AXPEntityCommandScope, entityDetailsEditAction, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterDeleteAction, entityMasterViewAction, entityOverrideDetailsViewAction, } from '@acorex-platform/framework-shared/entity';
-import { RootConfig } from './root-config';
-//#region ---- Command keys ----
-const ASSIGN_EXISTING_LOCATION = `${RootConfig.module.name}.${RootConfig.entities.locationAssignment.name}:AssignExistingLocation`;
-const CREATE_WITH_NEW_LOCATION = `${RootConfig.module.name}.${RootConfig.entities.locationAssignment.name}:CreateWithNewLocation`;
-//#endregion
-//#region ---- Location assignment related-entity actions ----
-const assigneeProcessOptions = () => ({
-    process: {
-        redirect: false,
-        canCreateNewOne: true,
-        data: {
-            'ownerRef.type': '{{ host.entity() }}',
-            'ownerRef.id': '{{ host.eval("id") }}',
-            'ownerRef.title': '{{ host.eval("party.title") }}',
-        },
-    },
-});
-/** Read-only assignments list on Location detail (no create/update/delete). */
-export function locationAssignmentReadOnlyRelatedActions() {
-    return [
-        { ...entityMasterCreateAction(), hidden: true },
-        { ...entityMasterBulkDeleteAction(), hidden: true },
-        { ...entityMasterDeleteAction(), hidden: true },
-        { ...entityMasterViewAction(), hidden: true },
-    ];
-}
-function locationAssignmentPartyCreateAction() {
-    const assigneeOptions = assigneeProcessOptions();
-    return {
-        name: 'Create',
-        title: '@general:actions.create.title',
-        command: { name: 'Entity:Create' },
-        icon: 'fa-light fa-plus',
-        priority: 'primary',
-        type: AXPSystemActionType.Create,
-        scope: AXPEntityCommandScope.TypeLevel,
-        items: [
-            {
-                name: 'AssignExistingLocation',
-                title: '@location-management:location-assignments.actions.assign-existing-location.title',
-                command: { name: ASSIGN_EXISTING_LOCATION, options: assigneeOptions },
-                icon: 'fa-light fa-map-marker-alt',
-                priority: 'primary',
-                type: AXPSystemActionType.Create,
-                scope: AXPEntityCommandScope.TypeLevel,
-            },
-            {
-                name: 'CreateWithNewLocation',
-                title: '@location-management:location-assignments.actions.create-with-new-location.title',
-                command: { name: CREATE_WITH_NEW_LOCATION, options: assigneeOptions },
-                icon: 'fa-light fa-location-plus',
-                priority: 'primary',
-                type: AXPSystemActionType.Create,
-                scope: AXPEntityCommandScope.TypeLevel,
-            },
-        ],
-    };
-}
-/**
- * Actions for LocationAssignment when shown from Party/Customer/Supplier.
- * Create menu: assign existing location or create new location with assignee prefilled.
- */
-export function locationAssignmentDetailsCrudActionsForPartyContext(_partyIdContextPath = 'id') {
-    return [
-        { ...entityMasterCreateAction(), hidden: true },
-        locationAssignmentPartyCreateAction(),
-        entityDetailsEditAction(),
-        entityOverrideDetailsViewAction(),
-    ];
-}
-//#endregion

package/contracts/location-assignment.utils.d.ts

@@ -1,53 +0,0 @@
-import type { AXPEntityProperty, AXPQueryFilter } from '@acorex-platform/framework-shared/entity';
-type LocationAssignmentLocationSnapshot = {
-    id: string;
-    title: string;
-    fullAddress?: string;
-    street1?: string;
-    street2?: string;
-    postalCode?: string;
-    city?: {
-        title: string;
-    };
-    state?: {
-        title: string;
-    };
-    country?: {
-        title: string;
-    };
-};
-type LocationAssignmentPersonSnapshot = {
-    id: string;
-    fullName?: string;
-    phones?: unknown[];
-    emails?: unknown[];
-};
-/** Canonical assignee type for party-scoped location assignment links. */
-export declare const LOCATION_ASSIGNMENT_PARTY_TYPE = "BusinessCore.Party";
-/** Resolves assignee display title from host/process data (plain string or multi-language object). */
-export declare function resolveLocationAssignmentDisplayTitle(locale: string, ...candidates: unknown[]): string;
-/** Builds a location snapshot for nested LocationAssignment display fields. */
-export declare function buildLocationAssignmentLocationSnapshot(locationRow: Record<string, unknown>, locationId: string): LocationAssignmentLocationSnapshot;
-/** Builds a person snapshot for nested LocationAssignment site-contact fields. */
-export declare function buildLocationAssignmentPersonSnapshot(personRow: Record<string, unknown>, personId: string): LocationAssignmentPersonSnapshot;
-/** Filters LocationAssignment rows for a location detail context. */
-export declare function locationAssignmentLocationConditions(locationIdContextPath?: string): AXPQueryFilter[];
-/** Filters LocationAssignment rows for the current details-view host entity. */
-export declare function locationAssignmentPartyConditions(hostIdContextPath?: string): AXPQueryFilter[];
-/** Assignee lookup omitted when injected from party/customer/supplier context. */
-export declare const LOCATION_ASSIGNMENT_REF_PROPERTY_NAMES: readonly ["ownerRef.id", "ownerRef.type"];
-/** Location lookup omitted when injected from location detail context. */
-export declare const LOCATION_ASSIGNMENT_LOCATION_PROPERTY_NAMES: readonly ["locationId"];
-type PropertyLayoutRef = {
-    name: string;
-    layout?: Record<string, unknown>;
-};
-export declare function omitLocationAssignmentRefFromEditLayouts<T extends PropertyLayoutRef>(layouts: T[]): T[];
-export declare function omitLocationAssignmentLocationFromEditLayouts<T extends PropertyLayoutRef>(layouts: T[]): T[];
-/** Polymorphic assignee lookup (AssessmentCase subjectRef pattern). */
-export declare function createLocationAssignmentOwnerRefLookupProperty(groupId: string, options?: {
-    readonly?: boolean;
-}): AXPEntityProperty;
-/** Hidden assignee type field; defaults to BusinessCore.Party. */
-export declare function createLocationAssignmentOwnerRefTypeProperty(groupId: string): AXPEntityProperty;
-export {};

package/contracts/location-assignment.utils.js

@@ -1,145 +0,0 @@
-//#region ---- Imports ----
-import { AXPWidgetsList, formatAddressData, resolveMultiLanguageString, } from '@acorex-platform/framework-shared/core';
-//#endregion
-//#region ---- Constants ----
-/** Canonical assignee type for party-scoped location assignment links. */
-export const LOCATION_ASSIGNMENT_PARTY_TYPE = 'BusinessCore.Party';
-//#endregion
-//#region ---- Display helpers ----
-/** Resolves assignee display title from host/process data (plain string or multi-language object). */
-export function resolveLocationAssignmentDisplayTitle(locale, ...candidates) {
-    for (const candidate of candidates) {
-        if (candidate == null || candidate === '') {
-            continue;
-        }
-        const resolved = resolveMultiLanguageString(candidate, locale).trim();
-        if (resolved) {
-            return resolved;
-        }
-    }
-    return '';
-}
-/** Builds a location snapshot for nested LocationAssignment display fields. */
-export function buildLocationAssignmentLocationSnapshot(locationRow, locationId) {
-    const fullAddress = locationRow['fullAddress']?.trim() || formatAddressData(locationRow)?.trim() || undefined;
-    const toRegionRef = (value) => {
-        if (value == null) {
-            return undefined;
-        }
-        if (typeof value === 'object') {
-            const record = value;
-            const title = record['title'];
-            return title != null ? { title: String(title) } : undefined;
-        }
-        return { title: String(value) };
-    };
-    return {
-        id: locationId,
-        title: locationRow['title'],
-        fullAddress,
-        street1: locationRow['street1'],
-        street2: locationRow['street2'],
-        postalCode: locationRow['postalCode'],
-        city: toRegionRef(locationRow['city']),
-        state: toRegionRef(locationRow['state']),
-        country: toRegionRef(locationRow['country']),
-    };
-}
-/** Builds a person snapshot for nested LocationAssignment site-contact fields. */
-export function buildLocationAssignmentPersonSnapshot(personRow, personId) {
-    const fullName = personRow['fullName'] ??
-        [personRow['firstName'], personRow['lastName']].filter(Boolean).join(' ').trim();
-    return {
-        id: personId,
-        fullName: fullName || undefined,
-        phones: personRow['phones'],
-        emails: personRow['emails'],
-    };
-}
-//#endregion
-//#region ---- Filter helpers ----
-/** Filters LocationAssignment rows for a location detail context. */
-export function locationAssignmentLocationConditions(locationIdContextPath = 'id') {
-    return [
-        {
-            name: 'locationId',
-            operator: { type: 'equal' },
-            value: `{{context.eval("${locationIdContextPath}")}}`,
-        },
-    ];
-}
-/** Filters LocationAssignment rows for the current details-view host entity. */
-export function locationAssignmentPartyConditions(hostIdContextPath = 'id') {
-    return [
-        {
-            name: 'ownerRef.type',
-            operator: { type: 'equal' },
-            value: '{{ host.entity() }}',
-        },
-        {
-            name: 'ownerRef.id',
-            operator: { type: 'equal' },
-            value: `{{ host.eval("${hostIdContextPath}") }}`,
-        },
-    ];
-}
-//#endregion
-//#region ---- Form layout helpers ----
-/** Assignee lookup omitted when injected from party/customer/supplier context. */
-export const LOCATION_ASSIGNMENT_REF_PROPERTY_NAMES = ['ownerRef.id', 'ownerRef.type'];
-/** Location lookup omitted when injected from location detail context. */
-export const LOCATION_ASSIGNMENT_LOCATION_PROPERTY_NAMES = ['locationId'];
-export function omitLocationAssignmentRefFromEditLayouts(layouts) {
-    return layouts.filter((layout) => !LOCATION_ASSIGNMENT_REF_PROPERTY_NAMES.includes(layout.name));
-}
-export function omitLocationAssignmentLocationFromEditLayouts(layouts) {
-    return layouts.filter((layout) => !LOCATION_ASSIGNMENT_LOCATION_PROPERTY_NAMES.includes(layout.name));
-}
-//#endregion
-//#region ---- Property factories ----
-/** Polymorphic assignee lookup (AssessmentCase subjectRef pattern). */
-export function createLocationAssignmentOwnerRefLookupProperty(groupId, options = {}) {
-    const readonly = options.readonly ?? false;
-    return {
-        name: 'ownerRef.id',
-        title: '@location-management:location-assignments.entities.location-assignment.fields.assignee.title',
-        groupId,
-        options: readonly
-            ? { sort: { enabled: false }, filter: { advance: { enabled: false }, inline: { enabled: false } } }
-            : { sort: { enabled: true }, filter: { advance: { enabled: true }, inline: { enabled: true } } },
-        schema: {
-            dataType: 'string',
-            readonly,
-            interface: {
-                type: AXPWidgetsList.Editors.LookupBox,
-                options: {
-                    readonly,
-                    entity: "{{ context.eval('ownerRef.type') }}",
-                    textField: 'title',
-                    valueField: 'id',
-                    expose: [
-                        { source: 'id', target: 'ownerRef.id' },
-                        { source: 'title', target: 'ownerRef.title' },
-                    ],
-                    triggers: [{ event: "{{ events.context('ownerRef.type') }}", action: '{{ widget.refresh() }}' }],
-                },
-            },
-        },
-        validations: [{ rule: 'required' }],
-    };
-}
-/** Hidden assignee type field; defaults to BusinessCore.Party. */
-export function createLocationAssignmentOwnerRefTypeProperty(groupId) {
-    return {
-        name: 'ownerRef.type',
-        title: '@location-management:location-assignments.entities.location-assignment.fields.assignee-type.title',
-        groupId,
-        schema: {
-            dataType: 'string',
-            visible: false,
-            defaultValue: LOCATION_ASSIGNMENT_PARTY_TYPE,
-            interface: { type: AXPWidgetsList.Editors.TextBox },
-        },
-    };
-}
-//#endregion

package/contracts/menu.keys.d.ts

@@ -1,8 +0,0 @@
-export declare const AXPLocationManagementMenuKeys: {
-    readonly Root: "location-management:menu";
-    readonly Locations: "location-management:menu:locations";
-    readonly Divider1: "location-management:menu:divider-1";
-    readonly LocationTypes: "location-management:menu:location-types";
-    readonly LocationRoles: "location-management:menu:location-roles";
-    readonly GeographicRegions: "location-management:menu:geographic-regions";
-};

package/contracts/menu.keys.js

@@ -1,8 +0,0 @@
-export const AXPLocationManagementMenuKeys = {
-    Root: 'location-management:menu',
-    Locations: 'location-management:menu:locations',
-    Divider1: 'location-management:menu:divider-1',
-    LocationTypes: 'location-management:menu:location-types',
-    LocationRoles: 'location-management:menu:location-roles',
-    GeographicRegions: 'location-management:menu:geographic-regions',
-};

package/contracts/package.json

@@ -1,5 +0,0 @@
-{
-  "module": "./index.js",
-  "typings": "./index.d.ts",
-  "sideEffects": false
-}

package/contracts/permission.keys.d.ts

@@ -1,33 +0,0 @@
-export declare const AXMLocationManagementPermissionsKeys: {
-    LocationManagement: {
-        Management: string;
-        Locations: {
-            Management: string;
-            View: string;
-            Edit: string;
-            Delete: string;
-            Create: string;
-        };
-        LocationTypes: {
-            Management: string;
-            View: string;
-            Edit: string;
-            Delete: string;
-            Create: string;
-        };
-        LocationRoles: {
-            Management: string;
-            View: string;
-            Edit: string;
-            Delete: string;
-            Create: string;
-        };
-        GeographicRegions: {
-            Management: string;
-            View: string;
-            Edit: string;
-            Delete: string;
-            Create: string;
-        };
-    };
-};

package/contracts/permission.keys.js

@@ -1,42 +0,0 @@
-import { AXPSystemActionType } from '@acorex-platform/framework-shared/core';
-import { RootConfig } from './root-config';
-const moduleKey = RootConfig.module.name;
-const entitiesKey = RootConfig.entities;
-const manageKey = AXPSystemActionType.Manage;
-const viewKey = AXPSystemActionType.View;
-const updateKey = AXPSystemActionType.Update;
-const deleteKey = AXPSystemActionType.Delete;
-const createKey = AXPSystemActionType.Create;
-export const AXMLocationManagementPermissionsKeys = {
-    LocationManagement: {
-        Management: `${moduleKey}:${manageKey}`,
-        Locations: {
-            Management: `${moduleKey}:${entitiesKey.location.name}:${manageKey}`,
-            View: `${moduleKey}:${entitiesKey.location.name}:${viewKey}`,
-            Edit: `${moduleKey}:${entitiesKey.location.name}:${updateKey}`,
-            Delete: `${moduleKey}:${entitiesKey.location.name}:${deleteKey}`,
-            Create: `${moduleKey}:${entitiesKey.location.name}:${createKey}`,
-        },
-        LocationTypes: {
-            Management: `${moduleKey}:${entitiesKey.locationType.name}:${manageKey}`,
-            View: `${moduleKey}:${entitiesKey.locationType.name}:${viewKey}`,
-            Edit: `${moduleKey}:${entitiesKey.locationType.name}:${updateKey}`,
-            Delete: `${moduleKey}:${entitiesKey.locationType.name}:${deleteKey}`,
-            Create: `${moduleKey}:${entitiesKey.locationType.name}:${createKey}`,
-        },
-        LocationRoles: {
-            Management: `${moduleKey}:${entitiesKey.locationRole.name}:${manageKey}`,
-            View: `${moduleKey}:${entitiesKey.locationRole.name}:${viewKey}`,
-            Edit: `${moduleKey}:${entitiesKey.locationRole.name}:${updateKey}`,
-            Delete: `${moduleKey}:${entitiesKey.locationRole.name}:${deleteKey}`,
-            Create: `${moduleKey}:${entitiesKey.locationRole.name}:${createKey}`,
-        },
-        GeographicRegions: {
-            Management: `${moduleKey}:${entitiesKey.geographicRegion.name}:${manageKey}`,
-            View: `${moduleKey}:${entitiesKey.geographicRegion.name}:${viewKey}`,
-            Edit: `${moduleKey}:${entitiesKey.geographicRegion.name}:${updateKey}`,
-            Delete: `${moduleKey}:${entitiesKey.geographicRegion.name}:${deleteKey}`,
-            Create: `${moduleKey}:${entitiesKey.geographicRegion.name}:${createKey}`,
-        },
-    },
-};