@randstad-uca/aws-sns-publisher 1.2.1 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -31,6 +31,7 @@ export declare const validEventTypes: {
31
31
  mail: string;
32
32
  push: string;
33
33
  addUserIdentity: string;
34
+ deleteOneSignalUser: string;
34
35
  };
35
36
  export declare const validDocumentStatus: {
36
37
  enviado: string;
@@ -34,6 +34,7 @@ exports.validEventTypes = {
34
34
  mail: 'mail',
35
35
  push: 'push',
36
36
  addUserIdentity: 'add-user-identity',
37
+ deleteOneSignalUser: 'delete-one-signal-user',
37
38
  };
38
39
  exports.validDocumentStatus = {
39
40
  enviado: 'enviado',
@@ -20,6 +20,7 @@ const email_schema_1 = require("./schemas/email.schema");
20
20
  const push_schema_1 = require("./schemas/push.schema");
21
21
  const cv_schema_1 = require("./schemas/cv.schema");
22
22
  const user_identity_schema_1 = require("./schemas/user-identity.schema");
23
+ const one_signal_schema_1 = require("./schemas/one-signal.schema");
23
24
  const schemas = {
24
25
  [constants_1.validEventTypes.sms]: { schema: sms_schema_1.SMSSchema, label: 'SMS' },
25
26
  [constants_1.validEventTypes.updatePersonalData]: {
@@ -114,6 +115,10 @@ const schemas = {
114
115
  schema: user_identity_schema_1.AddUserIdentitySchema,
115
116
  label: 'Add User Identity',
116
117
  },
118
+ [constants_1.validEventTypes.deleteOneSignalUser]: {
119
+ schema: one_signal_schema_1.DeleteOneSignalUserSchema,
120
+ label: 'Delete OneSignal User',
121
+ },
117
122
  };
118
123
  function getFieldsFromJoi(schema) {
119
124
  const description = schema.describe();
@@ -1,3 +1,4 @@
1
1
  import Joi from 'joi';
2
2
  export declare const SubscriptionSchema: Joi.ObjectSchema<any>;
3
3
  export declare const TagsTypeSchema: Joi.ObjectSchema<any>;
4
+ export declare const DeleteOneSignalUserSchema: Joi.ObjectSchema<any>;
@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
3
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.TagsTypeSchema = exports.SubscriptionSchema = void 0;
6
+ exports.DeleteOneSignalUserSchema = exports.TagsTypeSchema = exports.SubscriptionSchema = void 0;
7
7
  const joi_1 = __importDefault(require("joi"));
8
8
  exports.SubscriptionSchema = joi_1.default.object({
9
9
  id: joi_1.default.string().uuid().optional(),
@@ -30,3 +30,8 @@ exports.TagsTypeSchema = joi_1.default.object()
30
30
  .pattern(joi_1.default.string(), joi_1.default.any())
31
31
  .optional()
32
32
  .meta({ className: 'TagsType' });
33
+ exports.DeleteOneSignalUserSchema = joi_1.default.object({
34
+ userId: joi_1.default.string().uuid().required(),
35
+ })
36
+ .unknown(false)
37
+ .meta({ className: 'DeleteOneSignalUserType' });
@@ -2,6 +2,9 @@
2
2
  * This file was automatically generated by joi-to-typescript
3
3
  * Do not modify this file manually
4
4
  */
5
+ export interface DeleteOneSignalUserType {
6
+ userId: string;
7
+ }
5
8
  export interface SubscriptionType {
6
9
  app_id?: string;
7
10
  app_version: string;
@@ -16,6 +16,7 @@ const push_schema_1 = require("./schemas/push.schema");
16
16
  const cv_schema_1 = require("./schemas/cv.schema");
17
17
  const update_documents_status_schema_1 = require("./schemas/update-documents-status.schema");
18
18
  const user_identity_schema_1 = require("./schemas/user-identity.schema");
19
+ const one_signal_schema_1 = require("./schemas/one-signal.schema");
19
20
  const validateSchema = (eventType, data) => {
20
21
  let schema;
21
22
  switch (eventType) {
@@ -90,6 +91,9 @@ const validateSchema = (eventType, data) => {
90
91
  case constants_1.validEventTypes.addUserIdentity:
91
92
  schema = user_identity_schema_1.AddUserIdentitySchema;
92
93
  break;
94
+ case constants_1.validEventTypes.deleteOneSignalUser:
95
+ schema = one_signal_schema_1.DeleteOneSignalUserSchema;
96
+ break;
93
97
  default:
94
98
  console.error(`Unknown event type: ${eventType}`);
95
99
  return false;
package/package.json CHANGED
@@ -1,50 +1,50 @@
1
- {
2
- "name": "@randstad-uca/aws-sns-publisher",
3
- "version": "1.2.1",
4
- "description": "AWS SNS Publisher",
5
- "main": "./build/index.js",
6
- "types": "./build/index.d.ts",
7
- "files": [
8
- "build/**/*",
9
- "schema-doc.md"
10
- ],
11
- "scripts": {
12
- "clean": "rimraf build",
13
- "build": "npm run clean && npx tsc",
14
- "test": "echo \"No tests implemented yet\" && exit 0",
15
- "prepublishOnly": "npm run test && npm run generate-types && npm run generate-doc && npm run build",
16
- "pub": "npm publish",
17
- "generate-doc": "ts-node ./src/generate-schema-doc.ts",
18
- "generate-types": "ts-node ./src/generate-types.ts"
19
- },
20
- "keywords": [
21
- "aws",
22
- "sns",
23
- "publisher"
24
- ],
25
- "author": "Facundo Brusa",
26
- "repository": {
27
- "type": "git",
28
- "url": "git+https://github.com/randstad-argentina/aws-sns-publisher.git"
29
- },
30
- "bugs": {
31
- "url": "https://github.com/randstad-argentina/aws-sns-publisher/issues"
32
- },
33
- "homepage": "https://github.com/randstad-argentina/aws-sns-publisher#readme",
34
- "license": "ISC",
35
- "publishConfig": {
36
- "access": "public"
37
- },
38
- "devDependencies": {
39
- "@types/node": "^22.15.17",
40
- "joi-to-typescript": "^4.15.0",
41
- "rimraf": "^6.0.1",
42
- "ts-node": "^10.9.2",
43
- "typescript": "^5.7.3"
44
- },
45
- "dependencies": {
46
- "@aws-sdk/client-sns": "^3.741.0",
47
- "joi": "^17.13.3",
48
- "uuid": "^11.0.5"
49
- }
50
- }
1
+ {
2
+ "name": "@randstad-uca/aws-sns-publisher",
3
+ "version": "1.2.2",
4
+ "description": "AWS SNS Publisher",
5
+ "main": "./build/index.js",
6
+ "types": "./build/index.d.ts",
7
+ "files": [
8
+ "build/**/*",
9
+ "schema-doc.md"
10
+ ],
11
+ "scripts": {
12
+ "clean": "rimraf build",
13
+ "build": "npm run clean && npx tsc",
14
+ "test": "echo \"No tests implemented yet\" && exit 0",
15
+ "prepublishOnly": "npm run test && npm run generate-types && npm run generate-doc && npm run build",
16
+ "pub": "npm publish",
17
+ "generate-doc": "ts-node ./src/generate-schema-doc.ts",
18
+ "generate-types": "ts-node ./src/generate-types.ts"
19
+ },
20
+ "keywords": [
21
+ "aws",
22
+ "sns",
23
+ "publisher"
24
+ ],
25
+ "author": "Facundo Brusa",
26
+ "repository": {
27
+ "type": "git",
28
+ "url": "git+https://github.com/randstad-argentina/aws-sns-publisher.git"
29
+ },
30
+ "bugs": {
31
+ "url": "https://github.com/randstad-argentina/aws-sns-publisher/issues"
32
+ },
33
+ "homepage": "https://github.com/randstad-argentina/aws-sns-publisher#readme",
34
+ "license": "ISC",
35
+ "publishConfig": {
36
+ "access": "public"
37
+ },
38
+ "devDependencies": {
39
+ "@types/node": "^22.15.17",
40
+ "joi-to-typescript": "^4.15.0",
41
+ "rimraf": "^6.0.1",
42
+ "ts-node": "^10.9.2",
43
+ "typescript": "^5.7.3"
44
+ },
45
+ "dependencies": {
46
+ "@aws-sdk/client-sns": "^3.741.0",
47
+ "joi": "^17.13.3",
48
+ "uuid": "^11.0.5"
49
+ }
50
+ }
package/readme.md CHANGED
@@ -1,156 +1,156 @@
1
- # @randstad-uca/aws-sns-publisher
2
-
3
- ---
4
-
5
- Es una librería ligera desarrollada en Node.js para publicar mensajes a Amazon SNS de forma simple, validada y con logging configurable. Ideal para sistemas desacoplados y orientados a eventos en entornos AWS.
6
-
7
- ---
8
-
9
- ## 📦 Instalación
10
-
11
- ```bash
12
- npm install @randstad-uca/aws-sns-publisher
13
- ```
14
-
15
- ---
16
-
17
- ## 🚀 Uso Básico
18
-
19
- ```js
20
- import { SimpleSNSPublisher } from '@randstad-uca/aws-sns-publisher';
21
-
22
- const SNSClient = new SimpleSNSPublisher({
23
- awsConfig: { region: 'us-east-1' }, // required obj
24
- logEnabled: true, // optional (default value: true)
25
- logLevel: 'info', // optional (default value: info)
26
- throwError: true, // optional (default value: true)
27
- logHandler: {
28
- // You can implement your own logging handler here (optional)
29
- info: (args) =>
30
- // success case
31
- console.log('Custom success logging handler logic', args),
32
- error: (args) =>
33
- // error case
34
- console.error('Custom error logging handler logic', args),
35
- },
36
- });
37
-
38
- const payload = {
39
- eventType: 'sms',
40
- payload: {
41
- phone: '+543564123123',
42
- message: 'Hello there!',
43
- },
44
- };
45
-
46
- SNSClient.publish({
47
- message: JSON.stringify(payload),
48
- topicARN: 'your-sns-topic-ARN',
49
- apiName: 'api-name', // If the topic type is FIFO you must define a valid apiName
50
- })
51
- .then((result) => console.log('Success:', result))
52
- .catch((err) => console.error('Error:', err));
53
- ```
54
-
55
- ---
56
-
57
- ## 📘 API
58
-
59
- #### Clase: `SimpleSNSPublisher`
60
-
61
- ##### Constructor
62
- ```js
63
- new SimpleSNSPublisher(options: IPublisherOptions)
64
- ```
65
-
66
- `IPublisherOptions:`
67
-
68
- - `awsConfig: SNSClientConfig` – **Requerido**. Como minimo se debe especificar la región de AWS para instanciar el cliente SNS.
69
-
70
- - `logEnabled?: boolean` – Habilita logs. Default: `true`.
71
-
72
- - `logLevel?: 'info' | 'silent'` – Nivel de log. Default: `'info'`.
73
-
74
- - `throwError?: boolean` – Si lanzar errores o no. Default: `true`.
75
-
76
- - `logHandler?: { info: Function; error: Function }` – Handler personalizado para logs.
77
-
78
- ---
79
-
80
- ## ✨ Metodos
81
-
82
- #### Método: `publish(options: IPublishOptions): Promise<PublishResponse>`
83
-
84
- Publica un mensaje en un topic SNS. Antes de enviar el mensaje, se valida su estructura usando la libreria `Joi`.
85
-
86
- `IPublishOptions`:
87
-
88
- - `message: string` – Debe ser un string que contenga un objeto, y este **debe** tener las siguientes propiedades:
89
-
90
- - `eventType: string` – Tipo del evento (ej: `"sms"`, `"add-personal-data"` o cualquiera que se encuentre dentro del objeto ***validEventTypes*** ubicado en el archivo `constants.ts`).
91
-
92
- - `payload: object` – Objeto con los datos del evento.
93
-
94
- - `topicARN: string` – ARN del SNS Topic.
95
-
96
- - `apiName?: string` – Nombre de la API emisora, las unicas validas son las que se encuentran dentro del objeto ***validApiNames*** ubicado en el archivo `constants.ts`.
97
- <span style="color: red;">Esta se utiliza como bandera para la creación del MessageDeduplicationId y MessageGroupId necesarios en topics FIFO.</span>
98
-
99
-
100
- - `extraOptions?: object` – Parámetros adicionales para `PublishCommand`.
101
-
102
- **Validaciones automáticas:**
103
-
104
- - `eventType` es obligatorio y debe estar en la lista de eventos válidos.
105
-
106
- - Se valida el `payload` según el tipo de evento con esquemas Joi definidos internamente.
107
-
108
- - Si se configura `throwError: true`, lanza error. Si no, devuelve `Promise.reject()` con el error.
109
-
110
-
111
- #### Método: `validateSchema(eventType: string, payload: object): boolean`
112
-
113
- Valida el `payload` contra el esquema correspondiente según eventType.
114
-
115
- ---
116
-
117
- ### 📎 Ejemplo de payload válido
118
-
119
- ```json
120
- {
121
- "eventType": "email",
122
- "payload": {
123
- "to": "user@example.com",
124
- "subject": "Hello!",
125
- "body": "This is an example email."
126
- }
127
- }
128
- ```
129
-
130
- ---
131
-
132
- ## 📄 Schema Documentation
133
-
134
- See [schema-doc.md](./schema-doc.md) for a full list of event types and their schema fields
135
-
136
- ---
137
-
138
- 🧩 Características
139
-
140
- - ✅ Compatible con múltiples regiones AWS.
141
-
142
- - ✅ Validación automática con Joi.
143
-
144
- - ✅ Logging personalizable (info y error).
145
-
146
- - ✅ Ideal para arquitectura orientada a eventos.
147
-
148
- ---
149
-
150
- 📌 Consideraciones
151
-
152
- - Se espera que los topics estén previamente creados en SNS.
153
-
154
- - Esta librería no crea los topics automáticamente.
155
-
156
- - <span style="color:red">En caso de usar topics FIFO, es importante pasar un `apiName` **valido** para deduplicación.</span>
1
+ # @randstad-uca/aws-sns-publisher
2
+
3
+ ---
4
+
5
+ Es una librería ligera desarrollada en Node.js para publicar mensajes a Amazon SNS de forma simple, validada y con logging configurable. Ideal para sistemas desacoplados y orientados a eventos en entornos AWS.
6
+
7
+ ---
8
+
9
+ ## 📦 Instalación
10
+
11
+ ```bash
12
+ npm install @randstad-uca/aws-sns-publisher
13
+ ```
14
+
15
+ ---
16
+
17
+ ## 🚀 Uso Básico
18
+
19
+ ```js
20
+ import { SimpleSNSPublisher } from '@randstad-uca/aws-sns-publisher';
21
+
22
+ const SNSClient = new SimpleSNSPublisher({
23
+ awsConfig: { region: 'us-east-1' }, // required obj
24
+ logEnabled: true, // optional (default value: true)
25
+ logLevel: 'info', // optional (default value: info)
26
+ throwError: true, // optional (default value: true)
27
+ logHandler: {
28
+ // You can implement your own logging handler here (optional)
29
+ info: (args) =>
30
+ // success case
31
+ console.log('Custom success logging handler logic', args),
32
+ error: (args) =>
33
+ // error case
34
+ console.error('Custom error logging handler logic', args),
35
+ },
36
+ });
37
+
38
+ const payload = {
39
+ eventType: 'sms',
40
+ payload: {
41
+ phone: '+543564123123',
42
+ message: 'Hello there!',
43
+ },
44
+ };
45
+
46
+ SNSClient.publish({
47
+ message: JSON.stringify(payload),
48
+ topicARN: 'your-sns-topic-ARN',
49
+ apiName: 'api-name', // If the topic type is FIFO you must define a valid apiName
50
+ })
51
+ .then((result) => console.log('Success:', result))
52
+ .catch((err) => console.error('Error:', err));
53
+ ```
54
+
55
+ ---
56
+
57
+ ## 📘 API
58
+
59
+ #### Clase: `SimpleSNSPublisher`
60
+
61
+ ##### Constructor
62
+ ```js
63
+ new SimpleSNSPublisher(options: IPublisherOptions)
64
+ ```
65
+
66
+ `IPublisherOptions:`
67
+
68
+ - `awsConfig: SNSClientConfig` – **Requerido**. Como minimo se debe especificar la región de AWS para instanciar el cliente SNS.
69
+
70
+ - `logEnabled?: boolean` – Habilita logs. Default: `true`.
71
+
72
+ - `logLevel?: 'info' | 'silent'` – Nivel de log. Default: `'info'`.
73
+
74
+ - `throwError?: boolean` – Si lanzar errores o no. Default: `true`.
75
+
76
+ - `logHandler?: { info: Function; error: Function }` – Handler personalizado para logs.
77
+
78
+ ---
79
+
80
+ ## ✨ Metodos
81
+
82
+ #### Método: `publish(options: IPublishOptions): Promise<PublishResponse>`
83
+
84
+ Publica un mensaje en un topic SNS. Antes de enviar el mensaje, se valida su estructura usando la libreria `Joi`.
85
+
86
+ `IPublishOptions`:
87
+
88
+ - `message: string` – Debe ser un string que contenga un objeto, y este **debe** tener las siguientes propiedades:
89
+
90
+ - `eventType: string` – Tipo del evento (ej: `"sms"`, `"add-personal-data"` o cualquiera que se encuentre dentro del objeto ***validEventTypes*** ubicado en el archivo `constants.ts`).
91
+
92
+ - `payload: object` – Objeto con los datos del evento.
93
+
94
+ - `topicARN: string` – ARN del SNS Topic.
95
+
96
+ - `apiName?: string` – Nombre de la API emisora, las unicas validas son las que se encuentran dentro del objeto ***validApiNames*** ubicado en el archivo `constants.ts`.
97
+ <span style="color: red;">Esta se utiliza como bandera para la creación del MessageDeduplicationId y MessageGroupId necesarios en topics FIFO.</span>
98
+
99
+
100
+ - `extraOptions?: object` – Parámetros adicionales para `PublishCommand`.
101
+
102
+ **Validaciones automáticas:**
103
+
104
+ - `eventType` es obligatorio y debe estar en la lista de eventos válidos.
105
+
106
+ - Se valida el `payload` según el tipo de evento con esquemas Joi definidos internamente.
107
+
108
+ - Si se configura `throwError: true`, lanza error. Si no, devuelve `Promise.reject()` con el error.
109
+
110
+
111
+ #### Método: `validateSchema(eventType: string, payload: object): boolean`
112
+
113
+ Valida el `payload` contra el esquema correspondiente según eventType.
114
+
115
+ ---
116
+
117
+ ### 📎 Ejemplo de payload válido
118
+
119
+ ```json
120
+ {
121
+ "eventType": "email",
122
+ "payload": {
123
+ "to": "user@example.com",
124
+ "subject": "Hello!",
125
+ "body": "This is an example email."
126
+ }
127
+ }
128
+ ```
129
+
130
+ ---
131
+
132
+ ## 📄 Schema Documentation
133
+
134
+ See [schema-doc.md](./schema-doc.md) for a full list of event types and their schema fields
135
+
136
+ ---
137
+
138
+ 🧩 Características
139
+
140
+ - ✅ Compatible con múltiples regiones AWS.
141
+
142
+ - ✅ Validación automática con Joi.
143
+
144
+ - ✅ Logging personalizable (info y error).
145
+
146
+ - ✅ Ideal para arquitectura orientada a eventos.
147
+
148
+ ---
149
+
150
+ 📌 Consideraciones
151
+
152
+ - Se espera que los topics estén previamente creados en SNS.
153
+
154
+ - Esta librería no crea los topics automáticamente.
155
+
156
+ - <span style="color:red">En caso de usar topics FIFO, es importante pasar un `apiName` **valido** para deduplicación.</span>
package/schema-doc.md CHANGED
@@ -83,17 +83,6 @@ This file describes the required and optional fields for each `eventType`.
83
83
 
84
84
  ---
85
85
 
86
- ## Event: `update-certifications` (Update Certifications)
87
-
88
- **Required fields:**
89
- - `userId` (string)
90
- - `certificaciones` (string) (valid: 'si', 'no')
91
-
92
- **Optional fields:**
93
- - *(none)*
94
-
95
- ---
96
-
97
86
  ## Event: `add-work-experience` (Add Work Experience)
98
87
 
99
88
  **Required fields:**
@@ -350,3 +339,14 @@ This file describes the required and optional fields for each `eventType`.
350
339
  - `subscriptions` (object)
351
340
 
352
341
  ---
342
+
343
+ ## Event: `delete-one-signal-user` (Delete OneSignal User)
344
+
345
+ **Required fields:**
346
+ - `userId` (string)
347
+
348
+ **Optional fields:**
349
+ - *(none)*
350
+
351
+ ---
352
+