ad2app-lib 1.44.1 → 1.49.0

package/src/types/agency-billing.test.ts

@@ -0,0 +1,83 @@
+import { strict as assert } from 'node:assert';
+import { test } from 'node:test';
+
+import { ACCESS_DENIAL_CODES } from './I_AccessDenial';
+import type { I_AgencyBilling, I_SponsoredBy } from './agency';
+import { SchedulingSubscriptionInfoDTO } from './scheduling/I_SchedulingProUpgrade';
+
+/**
+ * Spec 175 US4 (T022/T024). The billing contract between backend and frontend:
+ * the settings screen, the creator's own subscription screen, and the one new
+ * refusal a sponsored creator can meet.
+ */
+
+test('a sponsored creator without a Stripe customer is refused the portal with its own code', () => {
+  assert.equal(ACCESS_DENIAL_CODES.SPONSORED_NO_PORTAL, 'sponsored-no-portal');
+});
+
+test('the subscription DTO carries sponsoredBy when the agency covers the plan', () => {
+  const sponsoredBy: I_SponsoredBy = { organizationName: 'Northlight', tier: 'pro', until: '2026-10-04T00:00:00.000Z' };
+  const dto = new SchedulingSubscriptionInfoDTO({
+    tier: 'pro',
+    status: 'active',
+    expiresAt: null,
+    maxAccounts: 10,
+    sponsoredBy,
+  });
+  assert.deepEqual(dto.sponsoredBy, sponsoredBy);
+});
+
+test('the subscription DTO leaves sponsoredBy ABSENT for everyone else, never null', () => {
+  const dto = new SchedulingSubscriptionInfoDTO({ tier: 'free', status: 'expired', expiresAt: null, maxAccounts: 0 });
+  assert.equal('sponsoredBy' in dto, false);
+});
+
+test('the billing overview names seats, price, invoices, who is covered and who left', () => {
+  const billing: I_AgencyBilling = {
+    subscriptionStatus: 'active',
+    seats: 3,
+    billedSeats: 3,
+    price: { amount: 2500, currency: 'USD', interval: 'month' },
+    currentPeriodEnd: '2026-10-04T00:00:00.000Z',
+    cancelAtPeriodEnd: false,
+    nextInvoice: { amount: 7500, currency: 'USD', date: '2026-10-04T00:00:00.000Z' },
+    discount: { name: 'First agency', percentOff: 100 },
+    paymentMethod: { brand: 'visa', last4: '4242', expMonth: 9, expYear: 2029 },
+    billingDetails: { name: 'Northlight Talent', email: 'kontakt@northlight.pl', country: 'PL' },
+    invoices: [
+      { id: 'in_1', number: 'AD2-0001', date: '2026-09-04T00:00:00.000Z', amount: 7500, currency: 'USD', status: 'paid' },
+    ],
+    covered: [
+      { grantId: 'g1', creator: { id: 'u1', handle: 'marta.moves' }, tier: 'pro', since: '2026-09-10T00:00:00.000Z' },
+      { grantId: 'g2', creator: { id: 'u2', handle: 'kubaplays' }, tier: null },
+    ],
+    pastCreators: [
+      {
+        grantId: 'g3',
+        creator: { id: null, handle: 'bartek.runs' },
+        endedAt: '2026-09-20T00:00:00.000Z',
+        endedBy: 'creator',
+        coveredUntil: '2026-10-04T00:00:00.000Z',
+      },
+    ],
+  };
+  assert.equal(billing.covered.filter((row) => row.tier !== null).length, 1);
+  assert.equal(billing.pastCreators[0].creator.id, null);
+});
+
+test('billedSeats is what Stripe bills: never below one, while seats is the creators with an active grant (review M1)', () => {
+  const billing: I_AgencyBilling = {
+    subscriptionStatus: 'none', seats: 0, billedSeats: 1, price: null, invoices: [], covered: [], pastCreators: [],
+  };
+  assert.equal(billing.billedSeats, 1);
+});
+
+test('the subscription DTO carries a RECENTLY ENDED coverage so the creator is told why the paywall is back (review M4, FR-014)', () => {
+  const dto = new SchedulingSubscriptionInfoDTO({
+    tier: 'free', status: 'expired', expiresAt: null, maxAccounts: 0,
+    sponsorshipEnded: { organizationName: 'Northlight', endedAt: '2026-10-04T00:00:00.000Z' },
+  });
+  assert.deepEqual(dto.sponsorshipEnded, { organizationName: 'Northlight', endedAt: '2026-10-04T00:00:00.000Z' });
+  const plain = new SchedulingSubscriptionInfoDTO({ tier: 'free', status: 'expired', expiresAt: null, maxAccounts: 0 });
+  assert.equal('sponsorshipEnded' in plain, false);
+});

package/src/types/agency-campaigns.test.ts

@@ -0,0 +1,85 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  AGENCY_CAMPAIGN_STEPS,
+  AGENCY_OFFER_STATUSES,
+  CAMPAIGN_PLACEMENTS,
+  CampaignOfferActDto,
+  CreateAgencyCampaignDto,
+  SETTLEMENT_FORMS,
+  isCampaignPlacement,
+} from "./agency-campaigns";
+import { I_OfferStatus } from "./I_Offer";
+
+test("the placements list is exactly FR-025's, one list per platform", () => {
+  assert.deepEqual(CAMPAIGN_PLACEMENTS, {
+    instagram: ["reel", "post", "carousel", "stories", "collab_post"],
+    tiktok: ["video", "repost", "duet", "stories"],
+    youtube: ["video", "short", "integration", "community_post"],
+    facebook: ["post", "reel", "stories"],
+    linkedin: ["post", "article"],
+  });
+});
+
+test("isCampaignPlacement checks the PAIR, and fails closed", () => {
+  assert.equal(isCampaignPlacement("instagram", "reel"), true);
+  assert.equal(isCampaignPlacement("youtube", "short"), true);
+  // A real placement on the wrong platform is not a placement.
+  assert.equal(isCampaignPlacement("linkedin", "reel"), false);
+  assert.equal(isCampaignPlacement("twitter", "post"), false);
+  // Prototype keys are not platforms.
+  assert.equal(isCampaignPlacement("constructor", "post"), false);
+  assert.equal(isCampaignPlacement("__proto__", "post"), false);
+});
+
+test("withdrawn is ADDED to the offer enum and the agency loop never writes the legacy-only values", () => {
+  assert.equal(I_OfferStatus.WITHDRAWN, "withdrawn");
+  for (const legacyOnly of [I_OfferStatus.DRAFT, I_OfferStatus.DELETED, I_OfferStatus.ALTERNATIVE_SUGGESTED]) {
+    assert.equal((AGENCY_OFFER_STATUSES as readonly string[]).includes(legacyOnly), false);
+  }
+});
+
+test("the board has FR-024's columns in loop order", () => {
+  assert.deepEqual(
+    [...AGENCY_CAMPAIGN_STEPS],
+    ["invited", "joined", "offer_sent", "negotiating", "confirmed", "material_in", "approved", "published"],
+  );
+});
+
+test("the settlement forms are the creator's three (FR-027)", () => {
+  assert.deepEqual([...SETTLEMENT_FORMS], ["invoice", "contract", "barter"]);
+});
+
+test("DTOs construct with no arguments, as the validation pipe does", () => {
+  assert.doesNotThrow(() => new CreateAgencyCampaignDto());
+  assert.doesNotThrow(() => new CampaignOfferActDto());
+  assert.equal(new CreateAgencyCampaignDto({ name: "Spring", text: "Concept" }).text, "Concept");
+});
+
+test("a material is a raster image or a video: SVG and HTML are refused (review L5)", async () => {
+  const { validate } = await import("class-validator");
+  const { PrepareMaterialUploadDto } = await import("./agency-campaigns");
+  const check = async (contentType: string) =>
+    (await validate(new PrepareMaterialUploadDto({ fileName: "f", contentType, sizeBytes: 1 }))).length === 0;
+  assert.equal(await check("video/mp4"), true);
+  assert.equal(await check("image/jpeg"), true);
+  assert.equal(await check("image/svg+xml"), false);
+  assert.equal(await check("text/html"), false);
+});
+
+test("thread messages are bounded and never empty (US8)", async () => {
+  const { validate } = await import("class-validator");
+  const { PostThreadMessageDto, THREAD_MESSAGE_MAX, AGENCY_THREAD_CODES } = await import("./agency-threads");
+  assert.equal((await validate(new PostThreadMessageDto({ text: "hi" }))).length, 0);
+  assert.notEqual((await validate(new PostThreadMessageDto({ text: "" }))).length, 0);
+  assert.notEqual((await validate(new PostThreadMessageDto({ text: "x".repeat(THREAD_MESSAGE_MAX + 1) }))).length, 0);
+  assert.equal(AGENCY_THREAD_CODES.CLOSED, "agency-thread-closed");
+});
+
+test("the picker's photo list and the API's rule are one rule (epic verify E7)", async () => {
+  const { MATERIAL_CONTENT_TYPE, MATERIAL_IMAGE_TYPES } = await import("./agency-campaigns");
+  for (const type of MATERIAL_IMAGE_TYPES) assert.equal(MATERIAL_CONTENT_TYPE.test(type), true, type);
+  for (const type of ["image/svg+xml", "text/plain", "image/pngx", "application/octet-stream", ""]) assert.equal(MATERIAL_CONTENT_TYPE.test(type), false, type);
+  assert.equal(MATERIAL_CONTENT_TYPE.test("video/quicktime"), true);
+});