@valentine-efagene/qshelter-common 2.0.86 → 2.0.88

package/dist/generated/client/models/QuestionnairePhase.js

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

package/dist/generated/client/models/index.d.ts

@@ -12,6 +12,7 @@ export * from './ContractTermination';
 export * from './DeviceEndpoint';
 export * from './DocumentRequirementRule';
 export * from './DocumentTemplate';
+export * from './DocumentationPhase';
 export * from './DocumentationStep';
 export * from './DocumentationStepApproval';
 export * from './DocumentationStepDocument';
@@ -26,7 +27,9 @@ export * from './OfferLetter';
 export * from './PasswordReset';
 export * from './PaymentMethodChangeRequest';
 export * from './PaymentMethodPhaseDocument';
+export * from './PaymentMethodPhaseField';
 export * from './PaymentMethodPhaseStep';
+export * from './PaymentPhase';
 export * from './PaymentPlan';
 export * from './Permission';
 export * from './Property';
@@ -41,6 +44,8 @@ export * from './PropertyUnit';
 export * from './PropertyVariant';
 export * from './PropertyVariantAmenity';
 export * from './PropertyVariantMedia';
+export * from './QuestionnaireField';
+export * from './QuestionnairePhase';
 export * from './RefreshToken';
 export * from './Role';
 export * from './RolePermission';

package/dist/generated/client/models/index.js

@@ -12,6 +12,7 @@ export * from './ContractTermination';
 export * from './DeviceEndpoint';
 export * from './DocumentRequirementRule';
 export * from './DocumentTemplate';
+export * from './DocumentationPhase';
 export * from './DocumentationStep';
 export * from './DocumentationStepApproval';
 export * from './DocumentationStepDocument';
@@ -26,7 +27,9 @@ export * from './OfferLetter';
 export * from './PasswordReset';
 export * from './PaymentMethodChangeRequest';
 export * from './PaymentMethodPhaseDocument';
+export * from './PaymentMethodPhaseField';
 export * from './PaymentMethodPhaseStep';
+export * from './PaymentPhase';
 export * from './PaymentPlan';
 export * from './Permission';
 export * from './Property';
@@ -41,6 +44,8 @@ export * from './PropertyUnit';
 export * from './PropertyVariant';
 export * from './PropertyVariantAmenity';
 export * from './PropertyVariantMedia';
+export * from './QuestionnaireField';
+export * from './QuestionnairePhase';
 export * from './RefreshToken';
 export * from './Role';
 export * from './RolePermission';

package/dist/generated/client/models.d.ts

@@ -31,9 +31,14 @@ export type * from './models/PropertyPaymentMethodPhase.js';
 export type * from './models/PaymentMethodPhaseStep.js';
 export type * from './models/StepEventAttachment.js';
 export type * from './models/PaymentMethodPhaseDocument.js';
+export type * from './models/PaymentMethodPhaseField.js';
 export type * from './models/Contract.js';
 export type * from './models/ContractRefund.js';
 export type * from './models/ContractPhase.js';
+export type * from './models/QuestionnairePhase.js';
+export type * from './models/DocumentationPhase.js';
+export type * from './models/PaymentPhase.js';
+export type * from './models/QuestionnaireField.js';
 export type * from './models/ContractEvent.js';
 export type * from './models/DocumentationStep.js';
 export type * from './models/DocumentationStepDocument.js';

package/dist/src/events/index.d.ts

@@ -3,5 +3,7 @@ export * from './notifications/notification-event';
 export * from './notifications/event-publisher';
 export * from './payments/payment-event';
 export * from './payments/payment-publisher';
+export * from './policies/policy-event';
+export * from './policies/policy-publisher';
 export * from './bus/event-bus.types';
 export * from './bus/event-bus.service';

package/dist/src/events/index.js

@@ -5,6 +5,9 @@ export * from './notifications/event-publisher';
 // Payment events and publisher (SNS-based)
 export * from './payments/payment-event';
 export * from './payments/payment-publisher';
+// Policy sync events and publisher (SNS-based)
+export * from './policies/policy-event';
+export * from './policies/policy-publisher';
 // Event bus (multi-transport delivery)
 export * from './bus/event-bus.types';
 export * from './bus/event-bus.service';

package/dist/src/events/policies/index.d.ts

@@ -0,0 +1,2 @@
+export * from './policy-event';
+export * from './policy-publisher';

package/dist/src/events/policies/index.js

@@ -0,0 +1,2 @@
+export * from './policy-event';
+export * from './policy-publisher';

package/dist/src/events/policies/policy-event.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Policy Sync Event Types
+ *
+ * These events are published when role/permission data changes in RDS,
+ * triggering synchronization to DynamoDB for the authorizer.
+ */
+export declare enum PolicyEventType {
+    ROLE_CREATED = "POLICY.ROLE_CREATED",
+    ROLE_UPDATED = "POLICY.ROLE_UPDATED",
+    ROLE_DELETED = "POLICY.ROLE_DELETED",
+    PERMISSION_CREATED = "POLICY.PERMISSION_CREATED",
+    PERMISSION_UPDATED = "POLICY.PERMISSION_UPDATED",
+    PERMISSION_DELETED = "POLICY.PERMISSION_DELETED",
+    ROLE_PERMISSION_ASSIGNED = "POLICY.ROLE_PERMISSION_ASSIGNED",
+    ROLE_PERMISSION_REVOKED = "POLICY.ROLE_PERMISSION_REVOKED",
+    FULL_SYNC_REQUESTED = "POLICY.FULL_SYNC_REQUESTED"
+}
+export interface RoleData {
+    id: string;
+    name: string;
+    description?: string | null;
+}
+export interface PermissionData {
+    id: string;
+    name: string;
+    description?: string | null;
+    resource: string;
+    action: string;
+}
+export interface RolePermissionData {
+    roleId: string;
+    roleName: string;
+    permissions: Array<{
+        id: string;
+        resource: string;
+        action: string;
+    }>;
+}
+export interface PolicyEventMeta {
+    source: string;
+    timestamp: string;
+    correlationId?: string;
+    userId?: string;
+    tenantId?: string;
+}
+export interface PolicyEvent<T = unknown> {
+    eventType: PolicyEventType;
+    eventId: string;
+    timestamp: string;
+    tenantId?: string;
+    source: string;
+    data: T;
+    metadata?: Record<string, unknown>;
+}
+export interface RoleCreatedEvent extends PolicyEvent<RoleData> {
+    eventType: PolicyEventType.ROLE_CREATED;
+}
+export interface RoleUpdatedEvent extends PolicyEvent<RoleData> {
+    eventType: PolicyEventType.ROLE_UPDATED;
+}
+export interface RoleDeletedEvent extends PolicyEvent<{
+    roleId: string;
+    roleName: string;
+}> {
+    eventType: PolicyEventType.ROLE_DELETED;
+}
+export interface PermissionCreatedEvent extends PolicyEvent<PermissionData> {
+    eventType: PolicyEventType.PERMISSION_CREATED;
+}
+export interface PermissionUpdatedEvent extends PolicyEvent<PermissionData> {
+    eventType: PolicyEventType.PERMISSION_UPDATED;
+}
+export interface PermissionDeletedEvent extends PolicyEvent<{
+    permissionId: string;
+}> {
+    eventType: PolicyEventType.PERMISSION_DELETED;
+}
+export interface RolePermissionAssignedEvent extends PolicyEvent<RolePermissionData> {
+    eventType: PolicyEventType.ROLE_PERMISSION_ASSIGNED;
+}
+export interface RolePermissionRevokedEvent extends PolicyEvent<RolePermissionData> {
+    eventType: PolicyEventType.ROLE_PERMISSION_REVOKED;
+}
+export interface FullSyncRequestedEvent extends PolicyEvent<{
+    requestedBy: string;
+}> {
+    eventType: PolicyEventType.FULL_SYNC_REQUESTED;
+}
+export type AnyPolicyEvent = RoleCreatedEvent | RoleUpdatedEvent | RoleDeletedEvent | PermissionCreatedEvent | PermissionUpdatedEvent | PermissionDeletedEvent | RolePermissionAssignedEvent | RolePermissionRevokedEvent | FullSyncRequestedEvent;

package/dist/src/events/policies/policy-event.js

@@ -0,0 +1,22 @@
+/**
+ * Policy Sync Event Types
+ *
+ * These events are published when role/permission data changes in RDS,
+ * triggering synchronization to DynamoDB for the authorizer.
+ */
+export var PolicyEventType;
+(function (PolicyEventType) {
+    // Role events
+    PolicyEventType["ROLE_CREATED"] = "POLICY.ROLE_CREATED";
+    PolicyEventType["ROLE_UPDATED"] = "POLICY.ROLE_UPDATED";
+    PolicyEventType["ROLE_DELETED"] = "POLICY.ROLE_DELETED";
+    // Permission events
+    PolicyEventType["PERMISSION_CREATED"] = "POLICY.PERMISSION_CREATED";
+    PolicyEventType["PERMISSION_UPDATED"] = "POLICY.PERMISSION_UPDATED";
+    PolicyEventType["PERMISSION_DELETED"] = "POLICY.PERMISSION_DELETED";
+    // Role-Permission association events
+    PolicyEventType["ROLE_PERMISSION_ASSIGNED"] = "POLICY.ROLE_PERMISSION_ASSIGNED";
+    PolicyEventType["ROLE_PERMISSION_REVOKED"] = "POLICY.ROLE_PERMISSION_REVOKED";
+    // Bulk sync events
+    PolicyEventType["FULL_SYNC_REQUESTED"] = "POLICY.FULL_SYNC_REQUESTED";
+})(PolicyEventType || (PolicyEventType = {}));

package/dist/src/events/policies/policy-publisher.d.ts

@@ -0,0 +1,60 @@
+import { PolicyEventType, PolicyEventMeta, RoleData, PermissionData, RolePermissionData } from './policy-event';
+/**
+ * Configuration for the policy event publisher
+ */
+interface PolicyPublisherConfig {
+    region?: string;
+    endpoint?: string;
+    topicArn?: string;
+}
+/**
+ * Policy Event Publisher for sending policy sync events to SNS
+ * Used by user-service to notify policy-sync-service of changes
+ */
+export declare class PolicyEventPublisher {
+    private readonly snsClient;
+    private readonly topicArn;
+    private readonly serviceName;
+    constructor(serviceName: string, config?: PolicyPublisherConfig);
+    /**
+     * Publish a policy event to SNS
+     */
+    publish<T>(eventType: PolicyEventType, data: T, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish role created event
+     */
+    publishRoleCreated(role: RoleData, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish role updated event
+     */
+    publishRoleUpdated(role: RoleData, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish role deleted event
+     */
+    publishRoleDeleted(roleId: string, roleName: string, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish permission created event
+     */
+    publishPermissionCreated(permission: PermissionData, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish permission updated event
+     */
+    publishPermissionUpdated(permission: PermissionData, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish permission deleted event
+     */
+    publishPermissionDeleted(permissionId: string, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish role permission assigned event
+     */
+    publishRolePermissionAssigned(data: RolePermissionData, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish role permission revoked event
+     */
+    publishRolePermissionRevoked(data: RolePermissionData, meta?: Partial<PolicyEventMeta>): Promise<string>;
+    /**
+     * Publish full sync requested event
+     */
+    publishFullSyncRequested(requestedBy: string, meta?: Partial<PolicyEventMeta>): Promise<string>;
+}
+export {};

package/dist/src/events/policies/policy-publisher.js

@@ -0,0 +1,128 @@
+import { SNSClient, PublishCommand } from '@aws-sdk/client-sns';
+import { PolicyEventType, } from './policy-event';
+/**
+ * Get SNS client configured for LocalStack or AWS
+ */
+function createSNSClient(config) {
+    const endpoint = config.endpoint || process.env.LOCALSTACK_ENDPOINT;
+    const region = config.region || process.env.AWS_REGION || 'us-east-1';
+    const clientConfig = { region };
+    // For LocalStack, set custom endpoint
+    if (endpoint) {
+        clientConfig.endpoint = endpoint;
+    }
+    return new SNSClient(clientConfig);
+}
+/**
+ * Policy Event Publisher for sending policy sync events to SNS
+ * Used by user-service to notify policy-sync-service of changes
+ */
+export class PolicyEventPublisher {
+    snsClient;
+    topicArn;
+    serviceName;
+    constructor(serviceName, config) {
+        this.serviceName = serviceName;
+        this.snsClient = createSNSClient(config || {});
+        // Topic ARN can be passed directly or constructed from env vars
+        const stage = process.env.STAGE || process.env.NODE_ENV || 'test';
+        const region = config?.region || process.env.AWS_REGION || 'us-east-1';
+        const accountId = process.env.AWS_ACCOUNT_ID || '000000000000';
+        this.topicArn = config?.topicArn ||
+            process.env.POLICY_SYNC_TOPIC_ARN ||
+            `arn:aws:sns:${region}:${accountId}:qshelter-${stage}-policy-sync`;
+    }
+    /**
+     * Publish a policy event to SNS
+     */
+    async publish(eventType, data, meta) {
+        const eventId = crypto.randomUUID();
+        const event = {
+            eventType,
+            eventId,
+            timestamp: new Date().toISOString(),
+            source: this.serviceName,
+            tenantId: meta?.tenantId,
+            data,
+            metadata: {
+                correlationId: meta?.correlationId || eventId,
+                userId: meta?.userId,
+            },
+        };
+        const command = new PublishCommand({
+            TopicArn: this.topicArn,
+            Message: JSON.stringify(event),
+            MessageAttributes: {
+                eventType: {
+                    DataType: 'String',
+                    StringValue: eventType,
+                },
+                source: {
+                    DataType: 'String',
+                    StringValue: this.serviceName,
+                },
+            },
+        });
+        const result = await this.snsClient.send(command);
+        console.log(`[PolicyEventPublisher] Published ${eventType} event to SNS`, {
+            topicArn: this.topicArn,
+            messageId: result.MessageId,
+            eventId,
+        });
+        return result.MessageId || '';
+    }
+    /**
+     * Publish role created event
+     */
+    async publishRoleCreated(role, meta) {
+        return this.publish(PolicyEventType.ROLE_CREATED, role, meta);
+    }
+    /**
+     * Publish role updated event
+     */
+    async publishRoleUpdated(role, meta) {
+        return this.publish(PolicyEventType.ROLE_UPDATED, role, meta);
+    }
+    /**
+     * Publish role deleted event
+     */
+    async publishRoleDeleted(roleId, roleName, meta) {
+        return this.publish(PolicyEventType.ROLE_DELETED, { roleId, roleName }, meta);
+    }
+    /**
+     * Publish permission created event
+     */
+    async publishPermissionCreated(permission, meta) {
+        return this.publish(PolicyEventType.PERMISSION_CREATED, permission, meta);
+    }
+    /**
+     * Publish permission updated event
+     */
+    async publishPermissionUpdated(permission, meta) {
+        return this.publish(PolicyEventType.PERMISSION_UPDATED, permission, meta);
+    }
+    /**
+     * Publish permission deleted event
+     */
+    async publishPermissionDeleted(permissionId, meta) {
+        return this.publish(PolicyEventType.PERMISSION_DELETED, { permissionId }, meta);
+    }
+    /**
+     * Publish role permission assigned event
+     */
+    async publishRolePermissionAssigned(data, meta) {
+        return this.publish(PolicyEventType.ROLE_PERMISSION_ASSIGNED, data, meta);
+    }
+    /**
+     * Publish role permission revoked event
+     */
+    async publishRolePermissionRevoked(data, meta) {
+        return this.publish(PolicyEventType.ROLE_PERMISSION_REVOKED, data, meta);
+    }
+    /**
+     * Publish full sync requested event
+     */
+    async publishFullSyncRequested(requestedBy, meta) {
+        return this.publish(PolicyEventType.FULL_SYNC_REQUESTED, { requestedBy }, meta);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valentine-efagene/qshelter-common",
-  "version": "2.0.86",
+  "version": "2.0.88",
   "description": "Shared database schemas and utilities for QShelter services",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",