@livex/contracts 0.1.0

package/dist/index.js

@@ -0,0 +1,327 @@
+import {
+  booking_confirmed_schema_default,
+  validateBookingConfirmed,
+  validateWebhookPaymentReceived,
+  validators,
+  webhook_payment_received_schema_default
+} from "./chunk-NVGKCJYM.js";
+
+// openapi/livex.v1.json
+var livex_v1_default = {
+  openapi: "3.1.0",
+  info: {
+    title: "LIVEX API",
+    version: "1.0.0",
+    description: "Contratos v1 del MVP: cat\xE1logo, disponibilidad, bookings y webhooks de pago.",
+    license: { name: "MIT", url: "https://opensource.org/licenses/MIT" }
+  },
+  servers: [{ url: "https://api.livex.app/v1" }],
+  security: [
+    { BearerAuth: [] }
+  ],
+  paths: {
+    "/experiences": {
+      get: {
+        summary: "Listar experiencias",
+        operationId: "listExperiences",
+        security: [],
+        parameters: [
+          { name: "q", in: "query", schema: { type: "string" } },
+          { name: "categoryId", in: "query", schema: { type: "string", format: "uuid" } },
+          { name: "limit", in: "query", schema: { type: "integer", minimum: 1, maximum: 100, default: 20 } },
+          { name: "offset", in: "query", schema: { type: "integer", minimum: 0, default: 0 } }
+        ],
+        responses: {
+          "200": {
+            description: "OK",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    items: { type: "array", items: { $ref: "#/components/schemas/ExperienceSummary" } },
+                    total: { type: "integer" }
+                  },
+                  required: ["items", "total"]
+                }
+              }
+            }
+          },
+          "400": { $ref: "#/components/responses/BadRequest" }
+        }
+      }
+    },
+    "/experiences/{experienceId}": {
+      get: {
+        summary: "Detalle de experiencia",
+        operationId: "getExperience",
+        security: [],
+        parameters: [
+          { name: "experienceId", in: "path", required: true, schema: { type: "string", format: "uuid" } }
+        ],
+        responses: {
+          "200": {
+            description: "OK",
+            content: { "application/json": { schema: { $ref: "#/components/schemas/Experience" } } }
+          },
+          "400": { $ref: "#/components/responses/BadRequest" },
+          "404": { $ref: "#/components/responses/NotFound" }
+        }
+      }
+    },
+    "/availability": {
+      get: {
+        summary: "Consultar disponibilidad por experiencia y fecha",
+        operationId: "getAvailability",
+        security: [],
+        parameters: [
+          { name: "experienceId", in: "query", required: true, schema: { type: "string", format: "uuid" } },
+          { name: "date", in: "query", required: true, schema: { type: "string", format: "date" } }
+        ],
+        responses: {
+          "200": {
+            description: "OK",
+            content: {
+              "application/json": {
+                schema: { type: "array", items: { $ref: "#/components/schemas/AvailabilitySlot" } }
+              }
+            }
+          },
+          "400": { $ref: "#/components/responses/BadRequest" }
+        }
+      }
+    },
+    "/bookings": {
+      post: {
+        summary: "Crear booking (pending + lock de inventario)",
+        operationId: "createBooking",
+        parameters: [
+          {
+            name: "Idempotency-Key",
+            in: "header",
+            required: true,
+            description: "Requerido para evitar duplicados en creaci\xF3n.",
+            schema: { type: "string", maxLength: 128 }
+          }
+        ],
+        requestBody: {
+          required: true,
+          content: { "application/json": { schema: { $ref: "#/components/schemas/CreateBookingInput" } } }
+        },
+        responses: {
+          "201": {
+            description: "Creado",
+            headers: {
+              Location: { schema: { type: "string" }, description: "URL del booking creado." }
+            },
+            content: { "application/json": { schema: { $ref: "#/components/schemas/Booking" } } }
+          },
+          "400": { $ref: "#/components/responses/BadRequest" },
+          "409": { $ref: "#/components/responses/Conflict" },
+          "422": { $ref: "#/components/responses/UnprocessableEntity" }
+        }
+      }
+    },
+    "/bookings/{bookingId}": {
+      get: {
+        summary: "Obtener booking por ID",
+        operationId: "getBooking",
+        parameters: [
+          { name: "bookingId", in: "path", required: true, schema: { type: "string", format: "uuid" } }
+        ],
+        responses: {
+          "200": { description: "OK", content: { "application/json": { schema: { $ref: "#/components/schemas/Booking" } } } },
+          "400": { $ref: "#/components/responses/BadRequest" },
+          "404": { $ref: "#/components/responses/NotFound" }
+        }
+      }
+    },
+    "/webhooks/payments/{provider}": {
+      post: {
+        summary: "Webhook de pagos (firma validada por API)",
+        operationId: "paymentsWebhook",
+        security: [],
+        parameters: [
+          { name: "provider", in: "path", required: true, schema: { type: "string", enum: ["wompi", "epayco", "other"] } }
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": { schema: { $ref: "#/components/schemas/PaymentWebhookPayload" } }
+          }
+        },
+        responses: {
+          "202": { description: "Aceptado para procesamiento as\xEDncrono" },
+          "400": { $ref: "#/components/responses/BadRequest" },
+          "401": { $ref: "#/components/responses/Unauthorized" }
+        }
+      }
+    }
+  },
+  components: {
+    securitySchemes: {
+      BearerAuth: {
+        type: "http",
+        scheme: "bearer",
+        bearerFormat: "JWT"
+      }
+    },
+    schemas: {
+      UUID: { type: "string", format: "uuid" },
+      Money: {
+        type: "object",
+        properties: {
+          amount: { type: "integer", minimum: 0, description: "Centavos" },
+          currency: { type: "string", minLength: 3, maxLength: 3, example: "COP" }
+        },
+        required: ["amount", "currency"],
+        additionalProperties: false
+      },
+      ExperienceSummary: {
+        type: "object",
+        properties: {
+          id: { $ref: "#/components/schemas/UUID" },
+          title: { type: "string" },
+          coverImageUrl: { type: "string", format: "uri" },
+          city: { type: "string" },
+          country: { type: "string" },
+          ratingAvg: { type: "number", minimum: 0, maximum: 5 },
+          ratingCount: { type: "integer", minimum: 0 },
+          fromPrice: { $ref: "#/components/schemas/Money" }
+        },
+        required: ["id", "title", "fromPrice"]
+      },
+      Experience: {
+        allOf: [
+          { $ref: "#/components/schemas/ExperienceSummary" },
+          {
+            type: "object",
+            properties: {
+              description: { type: "string" },
+              includes: { type: "array", items: { type: "string" } },
+              notIncludes: { type: "array", items: { type: "string" } },
+              images: { type: "array", items: { type: "string", format: "uri" } },
+              status: { type: "string", enum: ["draft", "under_review", "active", "rejected"] }
+            },
+            required: ["status"]
+          }
+        ]
+      },
+      AvailabilitySlot: {
+        type: "object",
+        properties: {
+          slotId: { $ref: "#/components/schemas/UUID" },
+          start: { type: "string", format: "date-time" },
+          end: { type: "string", format: "date-time" },
+          capacity: { type: "integer", minimum: 1 },
+          remaining: { type: "integer", minimum: 0 },
+          price: { $ref: "#/components/schemas/Money" }
+        },
+        required: ["slotId", "start", "end", "capacity", "remaining", "price"]
+      },
+      CreateBookingInput: {
+        type: "object",
+        properties: {
+          experienceId: { $ref: "#/components/schemas/UUID" },
+          slotId: { $ref: "#/components/schemas/UUID" },
+          quantity: { type: "integer", minimum: 1 },
+          buyer: {
+            type: "object",
+            properties: {
+              fullName: { type: "string" },
+              email: { type: "string", format: "email" },
+              phone: { type: "string" }
+            },
+            required: ["fullName", "email"]
+          },
+          payment: {
+            type: "object",
+            properties: {
+              method: { type: "string", enum: ["card", "pse", "cash", "other"] },
+              provider: { type: "string", enum: ["wompi", "epayco", "other"] }
+            },
+            required: ["method", "provider"]
+          }
+        },
+        required: ["experienceId", "slotId", "quantity", "buyer", "payment"],
+        additionalProperties: false
+      },
+      Booking: {
+        type: "object",
+        properties: {
+          id: { $ref: "#/components/schemas/UUID" },
+          status: { type: "string", enum: ["pending", "confirmed", "completed", "cancelled", "refunded", "expired"] },
+          experienceId: { $ref: "#/components/schemas/UUID" },
+          slotId: { $ref: "#/components/schemas/UUID" },
+          quantity: { type: "integer", minimum: 1 },
+          total: { $ref: "#/components/schemas/Money" },
+          createdAt: { type: "string", format: "date-time" }
+        },
+        required: ["id", "status", "experienceId", "slotId", "quantity", "total", "createdAt"]
+      },
+      PaymentWebhookPayload: {
+        type: "object",
+        properties: {
+          event: { type: "string", example: "transaction.updated" },
+          data: {
+            type: "object",
+            properties: {
+              providerRef: { type: "string" },
+              status: { type: "string", enum: ["APPROVED", "DECLINED", "VOIDED", "ERROR", "PENDING"] },
+              amountInCents: { type: "integer", minimum: 0 },
+              currency: { type: "string", minLength: 3, maxLength: 3 },
+              bookingId: { type: "string", format: "uuid", description: "Opcional si el flujo incluye referencia directa al booking." }
+            },
+            required: ["providerRef", "status", "amountInCents", "currency"]
+          },
+          sentAt: { type: "string", format: "date-time" }
+        },
+        required: ["event", "data"]
+      },
+      Error: {
+        type: "object",
+        properties: {
+          error_code: { type: "string" },
+          message: { type: "string" },
+          details: { type: ["object", "null"] }
+        },
+        required: ["error_code", "message"]
+      }
+    },
+    responses: {
+      BadRequest: {
+        description: "Solicitud inv\xE1lida",
+        content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } }
+      },
+      Unauthorized: { description: "No autorizado" },
+      NotFound: {
+        description: "No encontrado",
+        content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } }
+      },
+      Conflict: {
+        description: "Conflicto (idempotencia, duplicado, etc.)",
+        content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } }
+      },
+      UnprocessableEntity: {
+        description: "Validaci\xF3n fallida",
+        content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } }
+      }
+    }
+  }
+};
+
+// src/types.db.ts
+var types_db_exports = {};
+
+// src/index.ts
+var BookingConfirmed = booking_confirmed_schema_default;
+var WebhookPaymentReceived = webhook_payment_received_schema_default;
+export {
+  BookingConfirmed,
+  types_db_exports as DB,
+  WebhookPaymentReceived,
+  livex_v1_default as openapi,
+  validateBookingConfirmed,
+  validateWebhookPaymentReceived,
+  validators
+};

package/dist/validators.cjs

@@ -0,0 +1,117 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/validators.ts
+var validators_exports = {};
+__export(validators_exports, {
+  validateBookingConfirmed: () => validateBookingConfirmed,
+  validateWebhookPaymentReceived: () => validateWebhookPaymentReceived,
+  validators: () => validators
+});
+module.exports = __toCommonJS(validators_exports);
+var import_ajv = __toESM(require("ajv"), 1);
+var import_ajv_formats = __toESM(require("ajv-formats"), 1);
+
+// messages/booking.confirmed.schema.json
+var booking_confirmed_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://contracts.livex.app/messages/booking.confirmed.schema.json",
+  title: "booking.confirmed",
+  type: "object",
+  properties: {
+    eventType: { const: "booking.confirmed" },
+    eventId: { type: "string", format: "uuid" },
+    occurredAt: { type: "string", format: "date-time" },
+    booking: {
+      type: "object",
+      properties: {
+        id: { type: "string", format: "uuid" },
+        experienceId: { type: "string", format: "uuid" },
+        slotId: { type: "string", format: "uuid" },
+        quantity: { type: "integer", minimum: 1 },
+        totalInCents: { type: "integer", minimum: 0 },
+        currency: { type: "string", minLength: 3, maxLength: 3 }
+      },
+      required: ["id", "experienceId", "slotId", "quantity", "totalInCents", "currency"]
+    },
+    payment: {
+      type: "object",
+      properties: {
+        provider: { type: "string" },
+        providerRef: { type: "string" }
+      },
+      required: ["provider", "providerRef"]
+    },
+    request_id: { type: "string" }
+  },
+  required: ["eventType", "eventId", "occurredAt", "booking", "payment"],
+  additionalProperties: false
+};
+
+// messages/webhook.payment.received.schema.json
+var webhook_payment_received_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://contracts.livex.app/messages/webhook.payment.received.schema.json",
+  title: "webhook.payment.received",
+  type: "object",
+  properties: {
+    eventType: { const: "webhook.payment.received" },
+    eventId: { type: "string", format: "uuid" },
+    provider: { type: "string", enum: ["wompi", "epayco", "other"] },
+    provider_event_id: { type: "string" },
+    payload: { type: "object" },
+    receivedAt: { type: "string", format: "date-time" }
+  },
+  required: ["eventType", "eventId", "provider", "provider_event_id", "payload", "receivedAt"],
+  additionalProperties: false
+};
+
+// src/validators.ts
+var ajv = new import_ajv.default({ allErrors: true, strict: true });
+(0, import_ajv_formats.default)(ajv);
+var _validateBookingConfirmed = ajv.compile(booking_confirmed_schema_default);
+var _validateWebhookPaymentReceived = ajv.compile(webhook_payment_received_schema_default);
+function validateBookingConfirmed(payload) {
+  const ok = _validateBookingConfirmed(payload);
+  return { ok, errors: _validateBookingConfirmed.errors ?? null };
+}
+function validateWebhookPaymentReceived(payload) {
+  const ok = _validateWebhookPaymentReceived(payload);
+  return { ok, errors: _validateWebhookPaymentReceived.errors ?? null };
+}
+var validators = {
+  bookingConfirmed: validateBookingConfirmed,
+  webhookPaymentReceived: validateWebhookPaymentReceived
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateBookingConfirmed,
+  validateWebhookPaymentReceived,
+  validators
+});

package/dist/validators.d.cts

@@ -0,0 +1,16 @@
+import * as ajv from 'ajv';
+
+declare function validateBookingConfirmed(payload: unknown): {
+    ok: boolean;
+    errors: ajv.ErrorObject<string, Record<string, any>, unknown>[] | null;
+};
+declare function validateWebhookPaymentReceived(payload: unknown): {
+    ok: boolean;
+    errors: ajv.ErrorObject<string, Record<string, any>, unknown>[] | null;
+};
+declare const validators: {
+    bookingConfirmed: typeof validateBookingConfirmed;
+    webhookPaymentReceived: typeof validateWebhookPaymentReceived;
+};
+
+export { validateBookingConfirmed, validateWebhookPaymentReceived, validators };

package/dist/validators.d.ts

@@ -0,0 +1,16 @@
+import * as ajv from 'ajv';
+
+declare function validateBookingConfirmed(payload: unknown): {
+    ok: boolean;
+    errors: ajv.ErrorObject<string, Record<string, any>, unknown>[] | null;
+};
+declare function validateWebhookPaymentReceived(payload: unknown): {
+    ok: boolean;
+    errors: ajv.ErrorObject<string, Record<string, any>, unknown>[] | null;
+};
+declare const validators: {
+    bookingConfirmed: typeof validateBookingConfirmed;
+    webhookPaymentReceived: typeof validateWebhookPaymentReceived;
+};
+
+export { validateBookingConfirmed, validateWebhookPaymentReceived, validators };

package/dist/validators.js

@@ -0,0 +1,10 @@
+import {
+  validateBookingConfirmed,
+  validateWebhookPaymentReceived,
+  validators
+} from "./chunk-NVGKCJYM.js";
+export {
+  validateBookingConfirmed,
+  validateWebhookPaymentReceived,
+  validators
+};

package/messages/booking.confirmed.schema.json

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://contracts.livex.app/messages/booking.confirmed.schema.json",
+    "title": "booking.confirmed",
+    "type": "object",
+    "properties": {
+      "eventType": { "const": "booking.confirmed" },
+      "eventId": { "type": "string", "format": "uuid" },
+      "occurredAt": { "type": "string", "format": "date-time" },
+      "booking": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string", "format": "uuid" },
+          "experienceId": { "type": "string", "format": "uuid" },
+          "slotId": { "type": "string", "format": "uuid" },
+          "quantity": { "type": "integer", "minimum": 1 },
+          "totalInCents": { "type": "integer", "minimum": 0 },
+          "currency": { "type": "string", "minLength": 3, "maxLength": 3 }
+        },
+        "required": ["id","experienceId","slotId","quantity","totalInCents","currency"]
+      },
+      "payment": {
+        "type": "object",
+        "properties": {
+          "provider": { "type": "string" },
+          "providerRef": { "type": "string" }
+        },
+        "required": ["provider","providerRef"]
+      },
+      "request_id": { "type": "string" }
+    },
+    "required": ["eventType","eventId","occurredAt","booking","payment"],
+    "additionalProperties": false
+  }
+  

package/messages/webhook.payment.received.schema.json

@@ -0,0 +1,17 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://contracts.livex.app/messages/webhook.payment.received.schema.json",
+    "title": "webhook.payment.received",
+    "type": "object",
+    "properties": {
+      "eventType": { "const": "webhook.payment.received" },
+      "eventId": { "type": "string", "format": "uuid" },
+      "provider": { "type": "string", "enum": ["wompi","epayco","other"] },
+      "provider_event_id": { "type": "string" },
+      "payload": { "type": "object" },
+      "receivedAt": { "type": "string", "format": "date-time" }
+    },
+    "required": ["eventType","eventId","provider","provider_event_id","payload","receivedAt"],
+    "additionalProperties": false
+  }
+