@shipfox/api-integration-gitea 2.0.0

package/dist/presentation/routes/errors.js

@@ -0,0 +1,36 @@
+import { ConnectionSlugConflictError } from '@shipfox/api-integration-core-dto';
+import { ClientError } from '@shipfox/node-fastify';
+import { GiteaIntegrationProviderError, GiteaOrgAlreadyLinkedError, GiteaOrganizationNotFoundError } from '#core/errors.js';
+function providerStatus(reason) {
+    if (reason === 'rate-limited') return 429;
+    if (reason === 'timeout' || reason === 'provider-unavailable') return 503;
+    return 422;
+}
+export function giteaRouteErrorHandler(error) {
+    if (error instanceof GiteaOrganizationNotFoundError) {
+        throw new ClientError(error.message, 'gitea-organization-not-found', {
+            status: 404
+        });
+    }
+    if (error instanceof GiteaOrgAlreadyLinkedError) {
+        throw new ClientError(error.message, 'gitea-org-already-linked', {
+            status: 409
+        });
+    }
+    if (error instanceof ConnectionSlugConflictError) {
+        throw new ClientError(error.message, 'slug-conflict', {
+            status: 409
+        });
+    }
+    if (error instanceof GiteaIntegrationProviderError) {
+        throw new ClientError(error.message, error.reason, {
+            details: {
+                retry_after_seconds: error.retryAfterSeconds
+            },
+            status: providerStatus(error.reason)
+        });
+    }
+    throw error;
+}
+
+//# sourceMappingURL=errors.js.map

package/dist/presentation/routes/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/routes/errors.ts"],"sourcesContent":["import {\n  ConnectionSlugConflictError,\n  type IntegrationProviderErrorReason,\n} from '@shipfox/api-integration-core-dto';\nimport {ClientError} from '@shipfox/node-fastify';\nimport {\n  GiteaIntegrationProviderError,\n  GiteaOrgAlreadyLinkedError,\n  GiteaOrganizationNotFoundError,\n} from '#core/errors.js';\n\nfunction providerStatus(reason: IntegrationProviderErrorReason): number {\n  if (reason === 'rate-limited') return 429;\n  if (reason === 'timeout' || reason === 'provider-unavailable') return 503;\n  return 422;\n}\n\nexport function giteaRouteErrorHandler(error: unknown): never {\n  if (error instanceof GiteaOrganizationNotFoundError) {\n    throw new ClientError(error.message, 'gitea-organization-not-found', {status: 404});\n  }\n  if (error instanceof GiteaOrgAlreadyLinkedError) {\n    throw new ClientError(error.message, 'gitea-org-already-linked', {status: 409});\n  }\n  if (error instanceof ConnectionSlugConflictError) {\n    throw new ClientError(error.message, 'slug-conflict', {status: 409});\n  }\n  if (error instanceof GiteaIntegrationProviderError) {\n    throw new ClientError(error.message, error.reason, {\n      details: {retry_after_seconds: error.retryAfterSeconds},\n      status: providerStatus(error.reason),\n    });\n  }\n  throw error;\n}\n"],"names":["ConnectionSlugConflictError","ClientError","GiteaIntegrationProviderError","GiteaOrgAlreadyLinkedError","GiteaOrganizationNotFoundError","providerStatus","reason","giteaRouteErrorHandler","error","message","status","details","retry_after_seconds","retryAfterSeconds"],"mappings":"AAAA,SACEA,2BAA2B,QAEtB,oCAAoC;AAC3C,SAAQC,WAAW,QAAO,wBAAwB;AAClD,SACEC,6BAA6B,EAC7BC,0BAA0B,EAC1BC,8BAA8B,QACzB,kBAAkB;AAEzB,SAASC,eAAeC,MAAsC;IAC5D,IAAIA,WAAW,gBAAgB,OAAO;IACtC,IAAIA,WAAW,aAAaA,WAAW,wBAAwB,OAAO;IACtE,OAAO;AACT;AAEA,OAAO,SAASC,uBAAuBC,KAAc;IACnD,IAAIA,iBAAiBJ,gCAAgC;QACnD,MAAM,IAAIH,YAAYO,MAAMC,OAAO,EAAE,gCAAgC;YAACC,QAAQ;QAAG;IACnF;IACA,IAAIF,iBAAiBL,4BAA4B;QAC/C,MAAM,IAAIF,YAAYO,MAAMC,OAAO,EAAE,4BAA4B;YAACC,QAAQ;QAAG;IAC/E;IACA,IAAIF,iBAAiBR,6BAA6B;QAChD,MAAM,IAAIC,YAAYO,MAAMC,OAAO,EAAE,iBAAiB;YAACC,QAAQ;QAAG;IACpE;IACA,IAAIF,iBAAiBN,+BAA+B;QAClD,MAAM,IAAID,YAAYO,MAAMC,OAAO,EAAED,MAAMF,MAAM,EAAE;YACjDK,SAAS;gBAACC,qBAAqBJ,MAAMK,iBAAiB;YAAA;YACtDH,QAAQL,eAAeG,MAAMF,MAAM;QACrC;IACF;IACA,MAAME;AACR"}

package/dist/presentation/routes/webhooks.d.ts

@@ -0,0 +1,11 @@
+import type { GetIntegrationConnectionByIdFn, PublishSourcePushFn, RecordDeliveryOnlyFn } from '@shipfox/api-integration-core-dto';
+import { type RouteGroup } from '@shipfox/node-fastify';
+import type { NodePgDatabase } from 'drizzle-orm/node-postgres';
+export interface CreateGiteaWebhookRoutesOptions {
+    coreDb: () => NodePgDatabase<Record<string, unknown>>;
+    publishSourcePush: PublishSourcePushFn;
+    recordDeliveryOnly: RecordDeliveryOnlyFn;
+    getIntegrationConnectionById: GetIntegrationConnectionByIdFn;
+}
+export declare function createGiteaWebhookRoutes(options: CreateGiteaWebhookRoutesOptions): RouteGroup;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/presentation/routes/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/presentation/routes/webhooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAEL,KAAK,UAAU,EAIhB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,2BAA2B,CAAC;AAY9D,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,kBAAkB,EAAE,oBAAoB,CAAC;IACzC,4BAA4B,EAAE,8BAA8B,CAAC;CAC9D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,GAAG,UAAU,CA6E7F"}

package/dist/presentation/routes/webhooks.js

@@ -0,0 +1,109 @@
+import { Buffer } from 'node:buffer';
+import { defineRoute, rawBodyPlugin, verifyHexHmacSignature, WEBHOOK_BODY_LIMIT } from '@shipfox/node-fastify';
+import { logger } from '@shipfox/node-opentelemetry';
+import { config } from '#config.js';
+import { GiteaWebhookMalformedJsonError, GiteaWebhookMalformedPushPayloadError, handleGiteaWebhook } from '#core/webhook.js';
+const SIGNATURE_HEADER = 'x-gitea-signature';
+const EVENT_HEADER = 'x-gitea-event';
+const DELIVERY_HEADER = 'x-gitea-delivery';
+export function createGiteaWebhookRoutes(options) {
+    const pushRoute = defineRoute({
+        method: 'POST',
+        path: '/',
+        auth: [],
+        description: 'Gitea org webhook receiver.',
+        options: {
+            bodyLimit: WEBHOOK_BODY_LIMIT
+        },
+        handler: async (request, reply)=>{
+            const deliveryId = request.headers[DELIVERY_HEADER];
+            const signature = request.headers[SIGNATURE_HEADER];
+            const event = request.headers[EVENT_HEADER];
+            if (typeof deliveryId !== 'string' || !deliveryId) {
+                reply.code(400);
+                return {
+                    error: 'missing X-Gitea-Delivery header'
+                };
+            }
+            if (typeof signature !== 'string' || !signature) {
+                reply.code(401);
+                return {
+                    error: 'missing X-Gitea-Signature header'
+                };
+            }
+            if (typeof event !== 'string' || !event) {
+                reply.code(400);
+                return {
+                    error: 'missing X-Gitea-Event header'
+                };
+            }
+            const body = request.body;
+            if (!Buffer.isBuffer(body)) {
+                reply.code(400);
+                return {
+                    error: 'expected raw JSON body'
+                };
+            }
+            const rawBody = body.toString('utf8');
+            if (!verifyHexHmacSignature({
+                rawBody,
+                signature,
+                secret: config.GITEA_WEBHOOK_SECRET
+            })) {
+                reply.code(401);
+                return {
+                    error: 'invalid signature'
+                };
+            }
+            try {
+                await options.coreDb().transaction(async (tx)=>{
+                    await handleGiteaWebhook({
+                        tx,
+                        deliveryId,
+                        event,
+                        rawBody,
+                        publishSourcePush: options.publishSourcePush,
+                        recordDeliveryOnly: options.recordDeliveryOnly,
+                        getIntegrationConnectionById: options.getIntegrationConnectionById
+                    });
+                });
+            } catch (error) {
+                if (error instanceof GiteaWebhookMalformedJsonError) {
+                    logger().warn({
+                        deliveryId,
+                        err: error
+                    }, 'gitea webhook payload JSON parse failed');
+                    reply.code(400);
+                    return {
+                        error: 'malformed JSON'
+                    };
+                }
+                if (error instanceof GiteaWebhookMalformedPushPayloadError) {
+                    logger().warn({
+                        deliveryId,
+                        issues: error.issues
+                    }, 'gitea webhook push payload failed schema validation');
+                    reply.code(400);
+                    return {
+                        error: 'malformed push payload'
+                    };
+                }
+                throw error;
+            }
+            reply.code(204);
+            return null;
+        }
+    });
+    return {
+        prefix: '/webhooks/integrations/gitea',
+        auth: [],
+        plugins: [
+            rawBodyPlugin
+        ],
+        routes: [
+            pushRoute
+        ]
+    };
+}
+
+//# sourceMappingURL=webhooks.js.map

package/dist/presentation/routes/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/routes/webhooks.ts"],"sourcesContent":["import {Buffer} from 'node:buffer';\nimport type {\n  GetIntegrationConnectionByIdFn,\n  PublishSourcePushFn,\n  RecordDeliveryOnlyFn,\n} from '@shipfox/api-integration-core-dto';\nimport {\n  defineRoute,\n  type RouteGroup,\n  rawBodyPlugin,\n  verifyHexHmacSignature,\n  WEBHOOK_BODY_LIMIT,\n} from '@shipfox/node-fastify';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport type {NodePgDatabase} from 'drizzle-orm/node-postgres';\nimport {config} from '#config.js';\nimport {\n  GiteaWebhookMalformedJsonError,\n  GiteaWebhookMalformedPushPayloadError,\n  handleGiteaWebhook,\n} from '#core/webhook.js';\n\nconst SIGNATURE_HEADER = 'x-gitea-signature';\nconst EVENT_HEADER = 'x-gitea-event';\nconst DELIVERY_HEADER = 'x-gitea-delivery';\n\nexport interface CreateGiteaWebhookRoutesOptions {\n  coreDb: () => NodePgDatabase<Record<string, unknown>>;\n  publishSourcePush: PublishSourcePushFn;\n  recordDeliveryOnly: RecordDeliveryOnlyFn;\n  getIntegrationConnectionById: GetIntegrationConnectionByIdFn;\n}\n\nexport function createGiteaWebhookRoutes(options: CreateGiteaWebhookRoutesOptions): RouteGroup {\n  const pushRoute = defineRoute({\n    method: 'POST',\n    path: '/',\n    auth: [],\n    description: 'Gitea org webhook receiver.',\n    options: {bodyLimit: WEBHOOK_BODY_LIMIT},\n    handler: async (request, reply) => {\n      const deliveryId = request.headers[DELIVERY_HEADER];\n      const signature = request.headers[SIGNATURE_HEADER];\n      const event = request.headers[EVENT_HEADER];\n\n      if (typeof deliveryId !== 'string' || !deliveryId) {\n        reply.code(400);\n        return {error: 'missing X-Gitea-Delivery header'};\n      }\n      if (typeof signature !== 'string' || !signature) {\n        reply.code(401);\n        return {error: 'missing X-Gitea-Signature header'};\n      }\n      if (typeof event !== 'string' || !event) {\n        reply.code(400);\n        return {error: 'missing X-Gitea-Event header'};\n      }\n\n      const body = request.body;\n      if (!Buffer.isBuffer(body)) {\n        reply.code(400);\n        return {error: 'expected raw JSON body'};\n      }\n      const rawBody = body.toString('utf8');\n\n      if (!verifyHexHmacSignature({rawBody, signature, secret: config.GITEA_WEBHOOK_SECRET})) {\n        reply.code(401);\n        return {error: 'invalid signature'};\n      }\n\n      try {\n        await options.coreDb().transaction(async (tx) => {\n          await handleGiteaWebhook({\n            tx,\n            deliveryId,\n            event,\n            rawBody,\n            publishSourcePush: options.publishSourcePush,\n            recordDeliveryOnly: options.recordDeliveryOnly,\n            getIntegrationConnectionById: options.getIntegrationConnectionById,\n          });\n        });\n      } catch (error) {\n        if (error instanceof GiteaWebhookMalformedJsonError) {\n          logger().warn({deliveryId, err: error}, 'gitea webhook payload JSON parse failed');\n          reply.code(400);\n          return {error: 'malformed JSON'};\n        }\n        if (error instanceof GiteaWebhookMalformedPushPayloadError) {\n          logger().warn(\n            {deliveryId, issues: error.issues},\n            'gitea webhook push payload failed schema validation',\n          );\n          reply.code(400);\n          return {error: 'malformed push payload'};\n        }\n        throw error;\n      }\n\n      reply.code(204);\n      return null;\n    },\n  });\n\n  return {\n    prefix: '/webhooks/integrations/gitea',\n    auth: [],\n    plugins: [rawBodyPlugin],\n    routes: [pushRoute],\n  };\n}\n"],"names":["Buffer","defineRoute","rawBodyPlugin","verifyHexHmacSignature","WEBHOOK_BODY_LIMIT","logger","config","GiteaWebhookMalformedJsonError","GiteaWebhookMalformedPushPayloadError","handleGiteaWebhook","SIGNATURE_HEADER","EVENT_HEADER","DELIVERY_HEADER","createGiteaWebhookRoutes","options","pushRoute","method","path","auth","description","bodyLimit","handler","request","reply","deliveryId","headers","signature","event","code","error","body","isBuffer","rawBody","toString","secret","GITEA_WEBHOOK_SECRET","coreDb","transaction","tx","publishSourcePush","recordDeliveryOnly","getIntegrationConnectionById","warn","err","issues","prefix","plugins","routes"],"mappings":"AAAA,SAAQA,MAAM,QAAO,cAAc;AAMnC,SACEC,WAAW,EAEXC,aAAa,EACbC,sBAAsB,EACtBC,kBAAkB,QACb,wBAAwB;AAC/B,SAAQC,MAAM,QAAO,8BAA8B;AAEnD,SAAQC,MAAM,QAAO,aAAa;AAClC,SACEC,8BAA8B,EAC9BC,qCAAqC,EACrCC,kBAAkB,QACb,mBAAmB;AAE1B,MAAMC,mBAAmB;AACzB,MAAMC,eAAe;AACrB,MAAMC,kBAAkB;AASxB,OAAO,SAASC,yBAAyBC,OAAwC;IAC/E,MAAMC,YAAYd,YAAY;QAC5Be,QAAQ;QACRC,MAAM;QACNC,MAAM,EAAE;QACRC,aAAa;QACbL,SAAS;YAACM,WAAWhB;QAAkB;QACvCiB,SAAS,OAAOC,SAASC;YACvB,MAAMC,aAAaF,QAAQG,OAAO,CAACb,gBAAgB;YACnD,MAAMc,YAAYJ,QAAQG,OAAO,CAACf,iBAAiB;YACnD,MAAMiB,QAAQL,QAAQG,OAAO,CAACd,aAAa;YAE3C,IAAI,OAAOa,eAAe,YAAY,CAACA,YAAY;gBACjDD,MAAMK,IAAI,CAAC;gBACX,OAAO;oBAACC,OAAO;gBAAiC;YAClD;YACA,IAAI,OAAOH,cAAc,YAAY,CAACA,WAAW;gBAC/CH,MAAMK,IAAI,CAAC;gBACX,OAAO;oBAACC,OAAO;gBAAkC;YACnD;YACA,IAAI,OAAOF,UAAU,YAAY,CAACA,OAAO;gBACvCJ,MAAMK,IAAI,CAAC;gBACX,OAAO;oBAACC,OAAO;gBAA8B;YAC/C;YAEA,MAAMC,OAAOR,QAAQQ,IAAI;YACzB,IAAI,CAAC9B,OAAO+B,QAAQ,CAACD,OAAO;gBAC1BP,MAAMK,IAAI,CAAC;gBACX,OAAO;oBAACC,OAAO;gBAAwB;YACzC;YACA,MAAMG,UAAUF,KAAKG,QAAQ,CAAC;YAE9B,IAAI,CAAC9B,uBAAuB;gBAAC6B;gBAASN;gBAAWQ,QAAQ5B,OAAO6B,oBAAoB;YAAA,IAAI;gBACtFZ,MAAMK,IAAI,CAAC;gBACX,OAAO;oBAACC,OAAO;gBAAmB;YACpC;YAEA,IAAI;gBACF,MAAMf,QAAQsB,MAAM,GAAGC,WAAW,CAAC,OAAOC;oBACxC,MAAM7B,mBAAmB;wBACvB6B;wBACAd;wBACAG;wBACAK;wBACAO,mBAAmBzB,QAAQyB,iBAAiB;wBAC5CC,oBAAoB1B,QAAQ0B,kBAAkB;wBAC9CC,8BAA8B3B,QAAQ2B,4BAA4B;oBACpE;gBACF;YACF,EAAE,OAAOZ,OAAO;gBACd,IAAIA,iBAAiBtB,gCAAgC;oBACnDF,SAASqC,IAAI,CAAC;wBAAClB;wBAAYmB,KAAKd;oBAAK,GAAG;oBACxCN,MAAMK,IAAI,CAAC;oBACX,OAAO;wBAACC,OAAO;oBAAgB;gBACjC;gBACA,IAAIA,iBAAiBrB,uCAAuC;oBAC1DH,SAASqC,IAAI,CACX;wBAAClB;wBAAYoB,QAAQf,MAAMe,MAAM;oBAAA,GACjC;oBAEFrB,MAAMK,IAAI,CAAC;oBACX,OAAO;wBAACC,OAAO;oBAAwB;gBACzC;gBACA,MAAMA;YACR;YAEAN,MAAMK,IAAI,CAAC;YACX,OAAO;QACT;IACF;IAEA,OAAO;QACLiB,QAAQ;QACR3B,MAAM,EAAE;QACR4B,SAAS;YAAC5C;SAAc;QACxB6C,QAAQ;YAAChC;SAAU;IACrB;AACF"}