@m5kdev/module-social 0.34.0

package/dist/src/social.service.d.mts

@@ -0,0 +1,34 @@
+import { SocialPostInput } from "./social.dto.mjs";
+import { SocialPostResult, SocialProvider } from "./social.types.mjs";
+import { BaseService } from "@m5kdev/backend/base/base.service";
+import { ConnectRepository } from "@m5kdev/backend/modules/connect/connect.repository";
+import { FileService } from "@m5kdev/backend/modules/file/file.service";
+import { RequiredServiceActor } from "@m5kdev/backend/base/base.actor";
+import { ServerResultAsync } from "@m5kdev/backend/base/base.dto";
+import { ConnectService } from "@m5kdev/backend/modules/connect/connect.service";
+
+//#region src/social.service.d.ts
+declare class SocialService extends BaseService<{
+  connect: ConnectRepository;
+}, {
+  connect: ConnectService;
+  file: FileService;
+}> {
+  private providers;
+  constructor(repositories: {
+    connect: ConnectRepository;
+  }, services: {
+    connect: ConnectService;
+    file: FileService;
+  }, providers: SocialProvider[]);
+  getProvider(id: string): SocialProvider | null;
+  postToProvider(providerId: string, input: SocialPostInput, {
+    actor
+  }: {
+    actor: RequiredServiceActor<"user">;
+  }): ServerResultAsync<SocialPostResult>;
+  private ensureFreshConnection;
+}
+//#endregion
+export { SocialService };
+//# sourceMappingURL=social.service.d.mts.map

package/dist/src/social.service.mjs

@@ -0,0 +1,56 @@
+import { BaseService } from "@m5kdev/backend/base/base.service";
+import { err, ok } from "neverthrow";
+//#region src/social.service.ts
+var SocialService = class extends BaseService {
+	providers = /* @__PURE__ */ new Map();
+	constructor(repositories, services, providers) {
+		super(repositories, services);
+		this.providers = new Map(providers.map((provider) => [provider.id, provider]));
+	}
+	getProvider(id) {
+		return this.providers.get(id) ?? null;
+	}
+	async postToProvider(providerId, input, { actor }) {
+		const provider = this.getProvider(providerId);
+		if (!provider) return this.error("BAD_REQUEST", `Unknown provider: ${providerId}`);
+		const connectionResult = await this.repository.connect.list({
+			userId: actor.userId,
+			providers: [providerId]
+		});
+		if (connectionResult.isErr()) return this.error("INTERNAL_SERVER_ERROR", "Failed to load connection", { cause: connectionResult.error });
+		if (connectionResult.value.length === 0) return this.error("NOT_FOUND", `No connection found for provider: ${providerId}`);
+		const activeConnection = connectionResult.value.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())[0];
+		const connection = await this.ensureFreshConnection(activeConnection);
+		if (connection.isErr()) return this.error("INTERNAL_SERVER_ERROR", "Failed to refresh connection", { cause: connection.error });
+		const payload = {
+			text: input.text,
+			media: input.media,
+			visibility: input.visibility ?? "PUBLIC"
+		};
+		const accessToken = connection.value.accessToken;
+		if (!accessToken) return this.error("INTERNAL_SERVER_ERROR", "Missing access token for connection");
+		const result = await this.throwablePromise(() => provider.post({
+			deps: { fileService: this.service.file },
+			context: {
+				userId: actor.userId,
+				connection: connection.value,
+				accessToken
+			},
+			payload
+		}));
+		if (result.isErr()) return err(result.error);
+		return ok(result.value);
+	}
+	async ensureFreshConnection(connection) {
+		if (!connection.expiresAt || !connection.refreshToken) return ok(connection);
+		const expiresAt = new Date(connection.expiresAt);
+		if (Date.now() < expiresAt.getTime() - 60 * 1e3) return ok(connection);
+		const refreshed = await this.service.connect.refreshToken(connection.id);
+		if (refreshed.isErr()) return this.error("INTERNAL_SERVER_ERROR", "Failed to refresh access token", { cause: refreshed.error });
+		return ok(refreshed.value);
+	}
+};
+//#endregion
+export { SocialService };
+
+//# sourceMappingURL=social.service.mjs.map

package/dist/src/social.service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.service.mjs","names":[],"sources":["../../src/social.service.ts"],"sourcesContent":["import type { RequiredServiceActor } from \"@m5kdev/backend/base/base.actor\";\r\nimport type { ServerResultAsync } from \"@m5kdev/backend/base/base.dto\";\r\nimport { BaseService } from \"@m5kdev/backend/base/base.service\";\r\nimport type {\r\n  ConnectRepository,\r\n  ConnectRow,\r\n} from \"@m5kdev/backend/modules/connect/connect.repository\";\r\nimport type { ConnectService } from \"@m5kdev/backend/modules/connect/connect.service\";\r\nimport type { FileService } from \"@m5kdev/backend/modules/file/file.service\";\r\nimport { err, ok } from \"neverthrow\";\r\nimport type { SocialPostInput } from \"./social.dto\";\r\nimport type { SocialPostPayload, SocialPostResult, SocialProvider } from \"./social.types\";\r\n\r\nexport class SocialService extends BaseService<\r\n  {\r\n    connect: ConnectRepository;\r\n  },\r\n  {\r\n    connect: ConnectService;\r\n    file: FileService;\r\n  }\r\n> {\r\n  private providers = new Map<string, SocialProvider>();\r\n\r\n  constructor(\r\n    repositories: { connect: ConnectRepository },\r\n    services: { connect: ConnectService; file: FileService },\r\n    providers: SocialProvider[]\r\n  ) {\r\n    super(repositories, services);\r\n    this.providers = new Map(providers.map((provider) => [provider.id, provider]));\r\n  }\r\n\r\n  getProvider(id: string): SocialProvider | null {\r\n    return this.providers.get(id) ?? null;\r\n  }\r\n\r\n  async postToProvider(\r\n    providerId: string,\r\n    input: SocialPostInput,\r\n    { actor }: { actor: RequiredServiceActor<\"user\"> }\r\n  ): ServerResultAsync<SocialPostResult> {\r\n    const provider = this.getProvider(providerId);\r\n    if (!provider) {\r\n      return this.error(\"BAD_REQUEST\", `Unknown provider: ${providerId}`);\r\n    }\r\n\r\n    const connectionResult = await this.repository.connect.list({\r\n      userId: actor.userId,\r\n      providers: [providerId],\r\n    });\r\n\r\n    if (connectionResult.isErr()) {\r\n      return this.error(\"INTERNAL_SERVER_ERROR\", \"Failed to load connection\", {\r\n        cause: connectionResult.error,\r\n      });\r\n    }\r\n\r\n    if (connectionResult.value.length === 0) {\r\n      return this.error(\"NOT_FOUND\", `No connection found for provider: ${providerId}`);\r\n    }\r\n\r\n    const activeConnection = connectionResult.value.sort(\r\n      (a, b) => b.createdAt.getTime() - a.createdAt.getTime()\r\n    )[0];\r\n\r\n    const connection = await this.ensureFreshConnection(activeConnection);\r\n    if (connection.isErr()) {\r\n      return this.error(\"INTERNAL_SERVER_ERROR\", \"Failed to refresh connection\", {\r\n        cause: connection.error,\r\n      });\r\n    }\r\n\r\n    const payload: SocialPostPayload = {\r\n      text: input.text,\r\n      media: input.media,\r\n      visibility: input.visibility ?? \"PUBLIC\",\r\n    };\r\n\r\n    const accessToken = connection.value.accessToken;\r\n    if (!accessToken) {\r\n      // the connect callback always stores a token — a missing one is a data-integrity fault\r\n      return this.error(\"INTERNAL_SERVER_ERROR\", \"Missing access token for connection\");\r\n    }\r\n\r\n    const result = await this.throwablePromise(() =>\r\n      provider.post({\r\n        deps: { fileService: this.service.file },\r\n        context: {\r\n          userId: actor.userId,\r\n          connection: connection.value,\r\n          accessToken,\r\n        },\r\n        payload,\r\n      })\r\n    );\r\n    if (result.isErr()) return err(result.error);\r\n\r\n    return ok(result.value);\r\n  }\r\n\r\n  private async ensureFreshConnection(connection: ConnectRow): ServerResultAsync<ConnectRow> {\r\n    if (!connection.expiresAt || !connection.refreshToken) {\r\n      return ok(connection);\r\n    }\r\n\r\n    const expiresAt = new Date(connection.expiresAt);\r\n    const bufferMs = 60 * 1000; // Refresh 1 minute before expiry\r\n    if (Date.now() < expiresAt.getTime() - bufferMs) {\r\n      return ok(connection);\r\n    }\r\n\r\n    const refreshed = await this.service.connect.refreshToken(connection.id);\r\n    if (refreshed.isErr()) {\r\n      return this.error(\"INTERNAL_SERVER_ERROR\", \"Failed to refresh access token\", {\r\n        cause: refreshed.error,\r\n      });\r\n    }\r\n\r\n    return ok(refreshed.value);\r\n  }\r\n}\r\n"],"mappings":";;;AAaA,IAAa,gBAAb,cAAmC,YAQjC;CACA,4BAAoB,IAAI,KAA6B;CAErD,YACE,cACA,UACA,WACA;AACA,QAAM,cAAc,SAAS;AAC7B,OAAK,YAAY,IAAI,IAAI,UAAU,KAAK,aAAa,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC;;CAGhF,YAAY,IAAmC;AAC7C,SAAO,KAAK,UAAU,IAAI,GAAG,IAAI;;CAGnC,MAAM,eACJ,YACA,OACA,EAAE,SACmC;EACrC,MAAM,WAAW,KAAK,YAAY,WAAW;AAC7C,MAAI,CAAC,SACH,QAAO,KAAK,MAAM,eAAe,qBAAqB,aAAa;EAGrE,MAAM,mBAAmB,MAAM,KAAK,WAAW,QAAQ,KAAK;GAC1D,QAAQ,MAAM;GACd,WAAW,CAAC,WAAW;GACxB,CAAC;AAEF,MAAI,iBAAiB,OAAO,CAC1B,QAAO,KAAK,MAAM,yBAAyB,6BAA6B,EACtE,OAAO,iBAAiB,OACzB,CAAC;AAGJ,MAAI,iBAAiB,MAAM,WAAW,EACpC,QAAO,KAAK,MAAM,aAAa,qCAAqC,aAAa;EAGnF,MAAM,mBAAmB,iBAAiB,MAAM,MAC7C,GAAG,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,UAAU,SAAS,CACxD,CAAC;EAEF,MAAM,aAAa,MAAM,KAAK,sBAAsB,iBAAiB;AACrE,MAAI,WAAW,OAAO,CACpB,QAAO,KAAK,MAAM,yBAAyB,gCAAgC,EACzE,OAAO,WAAW,OACnB,CAAC;EAGJ,MAAM,UAA6B;GACjC,MAAM,MAAM;GACZ,OAAO,MAAM;GACb,YAAY,MAAM,cAAc;GACjC;EAED,MAAM,cAAc,WAAW,MAAM;AACrC,MAAI,CAAC,YAEH,QAAO,KAAK,MAAM,yBAAyB,sCAAsC;EAGnF,MAAM,SAAS,MAAM,KAAK,uBACxB,SAAS,KAAK;GACZ,MAAM,EAAE,aAAa,KAAK,QAAQ,MAAM;GACxC,SAAS;IACP,QAAQ,MAAM;IACd,YAAY,WAAW;IACvB;IACD;GACD;GACD,CAAC,CACH;AACD,MAAI,OAAO,OAAO,CAAE,QAAO,IAAI,OAAO,MAAM;AAE5C,SAAO,GAAG,OAAO,MAAM;;CAGzB,MAAc,sBAAsB,YAAuD;AACzF,MAAI,CAAC,WAAW,aAAa,CAAC,WAAW,aACvC,QAAO,GAAG,WAAW;EAGvB,MAAM,YAAY,IAAI,KAAK,WAAW,UAAU;AAEhD,MAAI,KAAK,KAAK,GAAG,UAAU,SAAS,GADnB,KAAK,IAEpB,QAAO,GAAG,WAAW;EAGvB,MAAM,YAAY,MAAM,KAAK,QAAQ,QAAQ,aAAa,WAAW,GAAG;AACxE,MAAI,UAAU,OAAO,CACnB,QAAO,KAAK,MAAM,yBAAyB,kCAAkC,EAC3E,OAAO,UAAU,OAClB,CAAC;AAGJ,SAAO,GAAG,UAAU,MAAM"}

package/dist/src/social.types.d.cts

@@ -0,0 +1,40 @@
+import { ConnectRow } from "@m5kdev/backend/modules/connect/connect.repository";
+import { FileService } from "@m5kdev/backend/modules/file/file.service";
+
+//#region src/social.types.d.ts
+type SocialMediaType = "image" | "video" | "document";
+interface SocialMediaDescriptor {
+  readonly s3Path: string;
+  readonly mediaType?: SocialMediaType;
+  readonly title?: string;
+  readonly description?: string;
+}
+type SocialVisibility = "PUBLIC" | "CONNECTIONS";
+interface SocialPostPayload {
+  readonly text: string;
+  readonly media?: readonly SocialMediaDescriptor[];
+  readonly visibility: SocialVisibility;
+}
+interface SocialProviderContext {
+  readonly userId: string;
+  readonly connection: ConnectRow;
+  readonly accessToken: string;
+}
+interface SocialProviderDeps {
+  readonly fileService: FileService;
+}
+interface SocialPostResult {
+  readonly shareUrn?: string;
+  readonly rawResponse?: unknown;
+}
+interface SocialProvider {
+  readonly id: string;
+  post(options: {
+    deps: SocialProviderDeps;
+    context: SocialProviderContext;
+    payload: SocialPostPayload;
+  }): Promise<SocialPostResult>;
+}
+//#endregion
+export { SocialMediaDescriptor, SocialMediaType, SocialPostPayload, SocialPostResult, SocialProvider, SocialProviderContext, SocialProviderDeps, SocialVisibility };
+//# sourceMappingURL=social.types.d.cts.map

package/dist/src/social.types.d.mts

@@ -0,0 +1,40 @@
+import { ConnectRow } from "@m5kdev/backend/modules/connect/connect.repository";
+import { FileService } from "@m5kdev/backend/modules/file/file.service";
+
+//#region src/social.types.d.ts
+type SocialMediaType = "image" | "video" | "document";
+interface SocialMediaDescriptor {
+  readonly s3Path: string;
+  readonly mediaType?: SocialMediaType;
+  readonly title?: string;
+  readonly description?: string;
+}
+type SocialVisibility = "PUBLIC" | "CONNECTIONS";
+interface SocialPostPayload {
+  readonly text: string;
+  readonly media?: readonly SocialMediaDescriptor[];
+  readonly visibility: SocialVisibility;
+}
+interface SocialProviderContext {
+  readonly userId: string;
+  readonly connection: ConnectRow;
+  readonly accessToken: string;
+}
+interface SocialProviderDeps {
+  readonly fileService: FileService;
+}
+interface SocialPostResult {
+  readonly shareUrn?: string;
+  readonly rawResponse?: unknown;
+}
+interface SocialProvider {
+  readonly id: string;
+  post(options: {
+    deps: SocialProviderDeps;
+    context: SocialProviderContext;
+    payload: SocialPostPayload;
+  }): Promise<SocialPostResult>;
+}
+//#endregion
+export { SocialMediaDescriptor, SocialMediaType, SocialPostPayload, SocialPostResult, SocialProvider, SocialProviderContext, SocialProviderDeps, SocialVisibility };
+//# sourceMappingURL=social.types.d.mts.map

package/dist/src/social.types.mjs

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

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@m5kdev/module-social",
+  "version": "0.34.0",
+  "description": "Optional Backend Module for posting to social networks through linked Connection accounts.",
+  "license": "GPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/michalkow/m5kdev.git"
+  },
+  "homepage": "https://github.com/michalkow/m5kdev#readme",
+  "bugs": "https://github.com/michalkow/m5kdev/issues",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@m5kdev/backend": "0.34.0"
+  },
+  "peerDependencies": {
+    "neverthrow": "8.2.0",
+    "zod": "4.2.1"
+  },
+  "devDependencies": {
+    "neverthrow": "8.2.0",
+    "tsdown": "0.21.7",
+    "tslib": "2.8.1",
+    "typescript": "6.0.3",
+    "zod": "4.2.1",
+    "@m5kdev/config": "0.34.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/src/social.module.d.mts",
+        "default": "./dist/src/social.module.mjs"
+      },
+      "require": {
+        "types": "./dist/src/social.module.d.cts",
+        "default": "./dist/src/social.module.cjs"
+      }
+    },
+    "./social.module": {
+      "import": {
+        "types": "./dist/src/social.module.d.mts",
+        "default": "./dist/src/social.module.mjs"
+      },
+      "require": {
+        "types": "./dist/src/social.module.d.cts",
+        "default": "./dist/src/social.module.cjs"
+      }
+    },
+    "./social.service": {
+      "import": {
+        "types": "./dist/src/social.service.d.mts",
+        "default": "./dist/src/social.service.mjs"
+      },
+      "require": {
+        "types": "./dist/src/social.service.d.cts",
+        "default": "./dist/src/social.service.cjs"
+      }
+    },
+    "./social.linkedin": {
+      "import": {
+        "types": "./dist/src/social.linkedin.d.mts",
+        "default": "./dist/src/social.linkedin.mjs"
+      },
+      "require": {
+        "types": "./dist/src/social.linkedin.d.cts",
+        "default": "./dist/src/social.linkedin.cjs"
+      }
+    },
+    "./social.dto": {
+      "import": {
+        "types": "./dist/src/social.dto.d.mts",
+        "default": "./dist/src/social.dto.mjs"
+      },
+      "require": {
+        "types": "./dist/src/social.dto.d.cts",
+        "default": "./dist/src/social.dto.cjs"
+      }
+    },
+    "./social.types": {
+      "import": {
+        "types": "./dist/src/social.types.d.mts",
+        "default": "./dist/src/social.types.mjs"
+      },
+      "require": {
+        "types": "./dist/src/social.types.d.cts",
+        "default": "./dist/src/social.types.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "version:patch": "npm version patch",
+    "lint": "biome check .",
+    "lint:fix": "biome check . --write",
+    "build": "tsdown",
+    "check-types": "tsc --noEmit"
+  }
+}