@abyss-project/link 0.0.0-stage → 1.1.0

package/src/types/interface/api/requests/link.admin.request.ts

@@ -0,0 +1,104 @@
+import { LinkKind } from '../../../enum/link.enum';
+import { ILinkOrigin } from '../../models/link.dto';
+import { QueryPaginate } from '../type-message/base-paginate';
+import { IGetLinkStatsQuery, ILinkIdParams } from './link.request';
+
+export interface IPaginateLinkAdminQuery extends QueryPaginate {
+  search?: string;
+  kind?: LinkKind;
+  userId?: string;
+  projectId?: string;
+  organizationId?: string;
+  isActive?: boolean;
+  isProtected?: boolean;
+}
+
+export type IGetLinkAdminParams = ILinkIdParams;
+export type IGetVisitsLinkAdminParams = ILinkIdParams;
+export type IGetVisitsLinkAdminQuery = QueryPaginate;
+export type IGetCampaignStatsLinkAdminParams = ILinkIdParams;
+export type ISetProtectionLinkAdminParams = ILinkIdParams;
+export type IUpdateLinkAdminParams = ILinkIdParams;
+export type IDeleteLinkAdminParams = ILinkIdParams;
+
+/** Human visits of `[from, to)`, read from the raw visits: days older than the retention count nothing. */
+export interface IGetCampaignStatsLinkAdminQuery {
+  from: Date | string;
+  to: Date | string;
+}
+
+export interface ISetProtectionLinkAdminBody {
+  isProtected: boolean;
+  /** The back-office administrator, recorded on the link and in abyss-main's audit. */
+  adminId: string;
+}
+
+/** What the back-office changes on a link: no password, which stays the owner's. */
+export interface IUpdateLinkAdminBody {
+  targetUrl?: string;
+  slug?: string;
+  title?: string | null;
+  description?: string | null;
+  isActive?: boolean;
+  expiresAt?: Date | string | null;
+  maxClicks?: number | null;
+}
+
+/** The kinds a product creates through `sdk.link.admin.create`; SHORTENED belongs to the user. */
+export type LinkProductKind = LinkKind.RESOURCE | LinkKind.CAMPAIGN_TOKEN;
+
+/**
+ * The container of a product's link (spec §4): kept for the deletion fan-out and the access, never
+ * a billing scope (a product's link is free on Link's lines).
+ */
+export interface ILinkContainerScope {
+  userId: string | null;
+  organizationId: string | null;
+  projectId: string | null;
+  /** The user acting in the product, when there is one. */
+  createdByUserId?: string | null;
+}
+
+/**
+ * A RESOURCE address (`<host>/<prefix>/<code>`) or a CAMPAIGN_TOKEN for a product resource. A
+ * RESOURCE is one per origin: a second call returns the existing link. A campaign token is a new
+ * token on each call, at most `LINK_CAMPAIGN_TOKENS_PER_PROJECT` per origin (422
+ * `link_campaign_token_limit` beyond).
+ */
+export interface ICreateLinkAdminBody {
+  kind: LinkProductKind;
+  origin: ILinkOrigin;
+  targetUrl: string;
+  scope: ILinkContainerScope;
+  /** A label the product shows, for example the channel of a campaign token. */
+  title?: string | null;
+}
+
+/** The product resource, flattened in the query string. */
+export type IGetByOriginLinkAdminQuery = ILinkOrigin;
+export type IGetStatsByOriginLinkAdminQuery = ILinkOrigin & IGetLinkStatsQuery;
+export type IListCampaignTokensLinkAdminQuery = ILinkOrigin;
+export type IDeleteCampaignTokenLinkAdminParams = ILinkIdParams;
+
+/** The campaign parameters of a page view, in the SDK's camelCase. */
+export interface ILinkVisitCampaign {
+  utmSource?: string;
+  utmMedium?: string;
+  utmCampaign?: string;
+  utmTerm?: string;
+  utmContent?: string;
+}
+
+/**
+ * A page view a product reports for a campaign token, after answering its visitor. Link hashes the
+ * visitor with the day's salt, looks the country and the city up locally and discards the IP: it is
+ * never stored, logged nor sent on.
+ */
+export interface IRecordCampaignViewLinkAdminBody {
+  token: string;
+  ip: string;
+  userAgent?: string;
+  /** The full referer: only its domain is kept. */
+  referer?: string;
+  utm?: ILinkVisitCampaign;
+}

package/src/types/interface/api/requests/link.public.request.ts

@@ -0,0 +1,18 @@
+export interface IUnlockLinkPublicParams {
+  slug: string;
+}
+
+/**
+ * The password of a shortened link, plus what the visit records about where the visitor came from:
+ * the unlock page reads them from the address the Link host sent it to (`?ref`, `?lang`, `utm_*`).
+ */
+export interface IUnlockLinkPublicBody {
+  password: string;
+  ref?: string;
+  lang?: string;
+  utmSource?: string;
+  utmMedium?: string;
+  utmCampaign?: string;
+  utmTerm?: string;
+  utmContent?: string;
+}

package/src/types/interface/api/requests/link.request.ts

@@ -0,0 +1,100 @@
+import { LinkShareScope } from '../../../enum/link-share.enum';
+import { LinkStatsGranularity } from '../../../enum/link-stats.enum';
+import { ILinkOrigin } from '../../models/link.dto';
+import { QueryPaginate } from '../type-message/base-paginate';
+
+export interface ILinkIdParams {
+  linkId: string;
+}
+
+export type IGetLinkParams = ILinkIdParams;
+export type IUpdateLinkParams = ILinkIdParams;
+export type IDeleteLinkParams = ILinkIdParams;
+export type ITransferLinkParams = ILinkIdParams;
+export type IGetLinkStatsParams = ILinkIdParams;
+export type IGetLinkVisitsParams = ILinkIdParams;
+
+/** Filters of the SHORTENED lists: `search` matches the title, the slug and the target URL. */
+export interface IPaginateLinkQuery extends QueryPaginate {
+  search?: string;
+  isActive?: boolean;
+}
+
+export interface IPaginateProjectLinkParams {
+  projectId: string;
+}
+
+export interface IPaginateOrganizationLinkParams {
+  organizationId: string;
+}
+
+export interface IPaginateOrganizationLinkQuery extends IPaginateLinkQuery {
+  scope?: LinkShareScope;
+  teamId?: string;
+  projectId?: string;
+  /** Honoured only for a member holding ORG_FULL_ACCESS. */
+  adminView?: boolean;
+}
+
+export interface ICountOrganizationLinkParams {
+  organizationId: string;
+}
+
+export interface ICountOrganizationLinkQuery {
+  adminView?: boolean;
+}
+
+/** A SHORTENED link. Without `slug`, a random one is drawn. */
+export interface ICreateLinkBody {
+  targetUrl: string;
+  slug?: string;
+  password?: string;
+  title?: string;
+  description?: string;
+  expiresAt?: Date | string;
+  maxClicks?: number;
+  forwardCampaignParams?: boolean;
+}
+
+export interface ICreateForOrganizationLinkParams {
+  organizationId: string;
+}
+
+/** `projectId` puts the link in a project; `scope: 'USER'` makes it the caller's within the organization. */
+export interface ICreateForOrganizationLinkBody extends ICreateLinkBody {
+  projectId?: string;
+  scope?: 'USER';
+}
+
+/** `password: null` removes the password; `expiresAt: null` and `maxClicks: null` lift the limit. */
+export interface IUpdateLinkBody {
+  targetUrl?: string;
+  slug?: string;
+  password?: string | null;
+  title?: string | null;
+  description?: string | null;
+  isActive?: boolean;
+  expiresAt?: Date | string | null;
+  maxClicks?: number | null;
+  forwardCampaignParams?: boolean;
+}
+
+export interface ITransferLinkBody {
+  newOwnerId: string;
+}
+
+/** Period `[from, to)`, 30 days up to now by default. */
+export interface IGetLinkStatsQuery {
+  from?: Date | string;
+  to?: Date | string;
+  granularity?: LinkStatsGranularity;
+}
+
+export type IGetLinkVisitsQuery = QueryPaginate;
+
+/**
+ * The product resource of a RESOURCE address, flattened in the query string: the product page
+ * finds its address and its statistics, from EDIT on the resource (spec §5).
+ */
+export type IGetByOriginLinkQuery = ILinkOrigin;
+export type IGetStatsByOriginLinkQuery = ILinkOrigin & IGetLinkStatsQuery;

package/src/types/interface/api/responses/abyss.admin.response.ts

@@ -0,0 +1,17 @@
+import { IUser, IOrganization, IProject } from '../..';
+import { IResponse } from '../type-message/response';
+
+export interface IActivateUserServiceAbyssAdminData {
+  user: IUser;
+}
+export type IActivateUserServiceAbyssAdminResponse = IResponse<IActivateUserServiceAbyssAdminData>;
+
+export interface ISyncOrganizationAbyssAdminData {
+  organization: IOrganization;
+}
+export type ISyncOrganizationAbyssAdminResponse = IResponse<ISyncOrganizationAbyssAdminData>;
+
+export interface ISyncProjectAbyssAdminData {
+  project: IProject;
+}
+export type ISyncProjectAbyssAdminResponse = IResponse<ISyncProjectAbyssAdminData>;

package/src/types/interface/api/responses/index.ts

@@ -0,0 +1,4 @@
+export * from './abyss.admin.response';
+export * from './link.response';
+export * from './link.admin.response';
+export * from './link.public.response';

package/src/types/interface/api/responses/link.admin.response.ts

@@ -0,0 +1,56 @@
+import { ILink, ILinkStats, ILinkVisit } from '../../models/link.dto';
+import { ILinkCampaignStatsRow } from '../../models/link-list.dto';
+import { BasePaginate } from '../type-message/base-paginate';
+import { IResponse } from '../type-message/response';
+
+export type IPaginateLinkAdminData = BasePaginate<ILink>;
+export type IPaginateLinkAdminResponse = IResponse<IPaginateLinkAdminData>;
+
+export interface IGetLinkAdminData {
+  link: ILink;
+}
+export type IGetLinkAdminResponse = IResponse<IGetLinkAdminData>;
+
+export type IGetVisitsLinkAdminData = BasePaginate<ILinkVisit>;
+export type IGetVisitsLinkAdminResponse = IResponse<IGetVisitsLinkAdminData>;
+
+export interface IGetCampaignStatsLinkAdminData {
+  rows: ILinkCampaignStatsRow[];
+}
+export type IGetCampaignStatsLinkAdminResponse = IResponse<IGetCampaignStatsLinkAdminData>;
+
+export interface ISetProtectionLinkAdminData {
+  link: ILink;
+}
+export type ISetProtectionLinkAdminResponse = IResponse<ISetProtectionLinkAdminData>;
+
+export interface IUpdateLinkAdminData {
+  link: ILink;
+}
+export type IUpdateLinkAdminResponse = IResponse<IUpdateLinkAdminData>;
+
+export type IDeleteLinkAdminResponse = IResponse<Record<string, never>>;
+
+export interface ICreateLinkAdminData {
+  link: ILink;
+}
+export type ICreateLinkAdminResponse = IResponse<ICreateLinkAdminData>;
+
+export interface IGetByOriginLinkAdminData {
+  link: ILink;
+}
+export type IGetByOriginLinkAdminResponse = IResponse<IGetByOriginLinkAdminData>;
+
+export interface IGetStatsByOriginLinkAdminData {
+  stats: ILinkStats;
+}
+export type IGetStatsByOriginLinkAdminResponse = IResponse<IGetStatsByOriginLinkAdminData>;
+
+export type IRecordCampaignViewLinkAdminResponse = IResponse<Record<string, never>>;
+
+export interface IListCampaignTokensLinkAdminData {
+  links: ILink[];
+}
+export type IListCampaignTokensLinkAdminResponse = IResponse<IListCampaignTokensLinkAdminData>;
+
+export type IDeleteCampaignTokenLinkAdminResponse = IResponse<Record<string, never>>;

package/src/types/interface/api/responses/link.public.response.ts

@@ -0,0 +1,7 @@
+import { IResponse } from '../type-message/response';
+
+export interface IUnlockLinkPublicData {
+  /** The destination, with the campaign parameters forwarded when the link asks for it. */
+  url: string;
+}
+export type IUnlockLinkPublicResponse = IResponse<IUnlockLinkPublicData>;

package/src/types/interface/api/responses/link.response.ts

@@ -0,0 +1,55 @@
+import { ILink, ILinkStats, ILinkVisit } from '../../models/link.dto';
+import { ILinkListItem } from '../../models/link-list.dto';
+import { BasePaginate } from '../type-message/base-paginate';
+import { IResponse } from '../type-message/response';
+
+export interface IGetLinkData {
+  link: ILink;
+}
+export type IGetLinkResponse = IResponse<IGetLinkData>;
+
+export type IPaginateLinkData = BasePaginate<ILinkListItem>;
+export type IPaginateLinkResponse = IResponse<IPaginateLinkData>;
+
+/** `orphan` and `unshared` are given to an organization administrator in `adminView` only. */
+export interface ICountOrganizationLinkData {
+  total: number;
+  orphan?: number;
+  unshared?: number;
+}
+export type ICountOrganizationLinkResponse = IResponse<ICountOrganizationLinkData>;
+
+export interface ICreateLinkData {
+  link: ILink;
+}
+export type ICreateLinkResponse = IResponse<ICreateLinkData>;
+
+export interface IUpdateLinkData {
+  link: ILink;
+}
+export type IUpdateLinkResponse = IResponse<IUpdateLinkData>;
+
+export type IDeleteLinkResponse = IResponse<Record<string, never>>;
+
+export interface ITransferLinkData {
+  link: ILink;
+}
+export type ITransferLinkResponse = IResponse<ITransferLinkData>;
+
+export interface IGetLinkStatsData {
+  stats: ILinkStats;
+}
+export type IGetLinkStatsResponse = IResponse<IGetLinkStatsData>;
+
+export type IGetLinkVisitsData = BasePaginate<ILinkVisit>;
+export type IGetLinkVisitsResponse = IResponse<IGetLinkVisitsData>;
+
+export interface IGetByOriginLinkData {
+  link: ILink;
+}
+export type IGetByOriginLinkResponse = IResponse<IGetByOriginLinkData>;
+
+export interface IGetStatsByOriginLinkData {
+  stats: ILinkStats;
+}
+export type IGetStatsByOriginLinkResponse = IResponse<IGetStatsByOriginLinkData>;

package/src/types/interface/api/type-message/api-error.ts

@@ -0,0 +1,7 @@
+import { Code, ErrorType } from '../../../enum';
+
+export interface IApiError {
+  code: Code;
+  type: ErrorType;
+  message?: string;
+}

package/src/types/interface/api/type-message/base-paginate.ts

@@ -0,0 +1,11 @@
+export interface BasePaginate<T> {
+  maxPages: number;
+  currentPage: number;
+  data: T[];
+  totalItems: number;
+}
+
+export interface QueryPaginate {
+  page?: number;
+  limit?: number;
+}

package/src/types/interface/api/type-message/response.ts

@@ -0,0 +1,6 @@
+import { IApiError } from './api-error';
+
+export interface IResponse<T> {
+  data: T;
+  error?: IApiError | Error;
+}

package/src/types/interface/index.ts

@@ -0,0 +1,2 @@
+export * from './models';
+export * from './api';

package/src/types/interface/models/index.ts

@@ -0,0 +1,5 @@
+export * from './user.dto';
+export * from './organization.dto';
+export * from './project.dto';
+export * from './link.dto';
+export * from './link-list.dto';

package/src/types/interface/models/link-list.dto.ts

@@ -0,0 +1,28 @@
+import { LinkSharePermission } from '../../enum/link-share.enum';
+import { ILink } from './link.dto';
+
+/** A content share of a link, as abyss-main holds it (the fields the Links screen shows). */
+export interface ILinkContentShare {
+  id: string;
+  /** `USER`, `TEAM`, `ORGANIZATION`, `PROJECT` or `PUBLIC` on abyss-main's side. */
+  targetType: string;
+  targetId: string | null;
+  permission: LinkSharePermission;
+  expiresAt: string | null;
+  createdByUserId: string | null;
+}
+
+/** A link of a list, with the caller's permission on it and its shares. */
+export interface ILinkListItem extends ILink {
+  permission: LinkSharePermission;
+  shares: ILinkContentShare[];
+}
+
+/** One row of the campaign statistics of a link: human visits grouped by campaign and medium. */
+export interface ILinkCampaignStatsRow {
+  utmCampaign: string | null;
+  utmMedium: string | null;
+  visits: number;
+  /** Sum over the days of the distinct visitors of each day (the visitor hash lives one day). */
+  uniqueVisitors: number;
+}

package/src/types/interface/models/link.dto.ts

@@ -0,0 +1,117 @@
+import { LinkKind, LinkResourceProduct, LinkVisitSource } from '../../enum/link.enum';
+import { IOrganization } from './organization.dto';
+import { IProject } from './project.dto';
+import { IUser } from './user.dto';
+
+/** The product resource a RESOURCE or CAMPAIGN_TOKEN link belongs to (spec §4). */
+export interface ILinkOrigin {
+  service: LinkResourceProduct;
+  /** Product-defined type, for example `beam_transfer`. */
+  resourceType: string;
+  resourceId: string;
+}
+
+/** A row of `links` (spec §7). Which address columns are set depends on `kind`. */
+export interface ILink {
+  id: string;
+  kind: LinkKind;
+  /** SHORTENED only, case kept as typed. */
+  slug: string | null;
+  /** SHORTENED only: `lower(slug)`, unique, the resolution key. */
+  slugKey: string | null;
+  /** RESOURCE only: a value of `LINK_RESOURCE_PREFIXES`. */
+  prefix: string | null;
+  /** RESOURCE only: base62, `LINK_RESOURCE_CODE_LENGTH` characters. */
+  code: string | null;
+  /** CAMPAIGN_TOKEN only: base62, `LINK_CAMPAIGN_TOKEN_LENGTH` characters. */
+  token: string | null;
+  targetUrl: string;
+  title: string | null;
+  description: string | null;
+  userId: string | null;
+  projectId: string | null;
+  organizationId: string | null;
+  createdByUserId: string | null;
+  /** Null for SHORTENED, set for RESOURCE and CAMPAIGN_TOKEN. */
+  originService: LinkResourceProduct | null;
+  originResourceType: string | null;
+  originResourceId: string | null;
+  isActive: boolean;
+  expiresAt: Date | null;
+  maxClicks: number | null;
+  /** SHORTENED only (scrypt, ADR-0238). */
+  passwordHash: string | null;
+  forwardCampaignParams: boolean;
+  isProtected: boolean;
+  protectedAt: Date | null;
+  protectedByAdminId: string | null;
+  /** Display values refreshed by the daily rollup; never read to decide a resolution. */
+  clickCount: number;
+  uniqueClickCount: number;
+  lastVisitedAt: Date | null;
+  createdAt?: Date;
+  updatedAt?: Date;
+
+  user?: IUser | null;
+  project?: IProject | null;
+  organization?: IOrganization | null;
+}
+
+/** A row of `link_visits` (spec §7). No IP, no full referer, no raw user agent. */
+export interface ILinkVisit {
+  id: string;
+  linkId: string;
+  visitedAt: Date;
+  source: LinkVisitSource;
+  /** `hashVisitor` of the visit's UTC day: comparable within one day only. */
+  visitorHash: string;
+  isBot: boolean;
+  isFirstOfDay: boolean;
+  country: string | null;
+  city: string | null;
+  device: string | null;
+  browser: string | null;
+  os: string | null;
+  language: string | null;
+  refererDomain: string | null;
+  utmSource: string | null;
+  utmMedium: string | null;
+  utmCampaign: string | null;
+  utmTerm: string | null;
+  utmContent: string | null;
+}
+
+/** Visit counts by value, human visits only (spec §3.4). */
+export interface ILinkBreakdowns {
+  countries: Record<string, number>;
+  cities: Record<string, number>;
+  devices: Record<string, number>;
+  browsers: Record<string, number>;
+  oses: Record<string, number>;
+  languages: Record<string, number>;
+  refererDomains: Record<string, number>;
+  utmSources: Record<string, number>;
+  utmMediums: Record<string, number>;
+  utmCampaigns: Record<string, number>;
+}
+
+/** A row of `link_daily_stats`: one per link and UTC day (spec §3.4). */
+export interface ILinkDailyStats extends ILinkBreakdowns {
+  linkId: string;
+  /** UTC day, `YYYY-MM-DD`. */
+  day: string;
+  /** Human visits. */
+  visits: number;
+  /** Distinct visitor hashes of the day. */
+  uniqueVisitors: number;
+  botVisits: number;
+}
+
+/** Statistics of a link over a period. `uniqueVisitors` is the sum of the daily distinct visitors. */
+export interface ILinkStats extends ILinkBreakdowns {
+  visits: number;
+  uniqueVisitors: number;
+  botVisits: number;
+  lastVisitedAt: Date | null;
+  daily: ILinkDailyStats[];
+}

package/src/types/interface/models/organization.dto.ts

@@ -0,0 +1,21 @@
+import { IProject } from './project.dto';
+
+export interface IOrganization {
+  id?: string;
+  name: string;
+  slug: string;
+  // Mirror of abyss-main Organization.kind. Drives the family default-share
+  // permission (family → EDIT, else VIEW). Synced by organization.middleware.ts.
+  // Typed as a literal union that mirrors @abyss-project/main's OrganizationKind
+  // enum values 1:1 — this published SDK package intentionally does NOT depend on
+  // @abyss-project/main, so the enum is referenced by value (the api-side model
+  // and middleware narrow this to OrganizationKind, where main IS resolvable).
+  kind?: 'standard' | 'family';
+  // Last refresh of `kind` from abyss-main; drives the TTL (≤5min) sync gate.
+  kindSyncedAt?: string | null;
+  updatedAt?: Date;
+  createdAt?: Date;
+
+  // Associations
+  projects?: IProject[];
+}

package/src/types/interface/models/project.dto.ts

@@ -0,0 +1,16 @@
+import { IOrganization } from './organization.dto';
+import { IUser } from './user.dto';
+
+export interface IProject {
+  id?: string;
+  name: string;
+  // Historical creator of the project, null once their account is deleted. NOT used for access control.
+  createdByUserId: string | null;
+  organizationId: string;
+  updatedAt?: Date;
+  createdAt?: Date;
+
+  // Associations
+  organization?: IOrganization;
+  user?: IUser;
+}

package/src/types/interface/models/user.dto.ts

@@ -0,0 +1,19 @@
+import { IProject } from './project.dto';
+
+export interface IUser {
+  id?: string;
+  isAdmin: boolean;
+  // Personal API key mirror from abyss-main (ADR-0037). The lookup hash is the
+  // non-reversible sha256 fingerprint used for local validation; revokedAt marks
+  // a mirrored key that must no longer authenticate.
+  personalApiKeyLookupHash?: string | null;
+  personalApiKeyRevokedAt?: Date | null;
+  // Set when the account was deleted in abyss-main (USER_DELETED, #199): the row stays, marked,
+  // and a session token signed before the deletion no longer authenticates.
+  accountDeletedAt?: Date | null;
+  updatedAt?: Date;
+  createdAt?: Date;
+
+  // Associations
+  projects?: IProject[];
+}

package/src/types/tests/link-enums.spec.ts

@@ -0,0 +1,48 @@
+import {
+  CAMPAIGN_TOKEN_QUERY_PARAM,
+  LINK_CAMPAIGN_TOKEN_LENGTH,
+  LINK_CAMPAIGN_TOKENS_PER_PROJECT,
+  LINK_RESOURCE_CODE_LENGTH,
+  LINK_VISIT_RETENTION_DAYS,
+  LinkKind,
+  LinkResourceProduct,
+  LinkVisitSource,
+  MAX_LINK_PASSWORD_LENGTH,
+  MIN_LINK_PASSWORD_LENGTH,
+} from '../..';
+
+describe('link enums: stored values', () => {
+  it('LinkKind has exactly the three kinds of spec §2', () => {
+    expect(Object.values(LinkKind)).toEqual(['SHORTENED', 'RESOURCE', 'CAMPAIGN_TOKEN']);
+  });
+
+  it('LinkVisitSource has exactly REDIRECT and CAMPAIGN_VIEW', () => {
+    expect(Object.values(LinkVisitSource)).toEqual(['REDIRECT', 'CAMPAIGN_VIEW']);
+  });
+
+  it('LinkResourceProduct has exactly the products of spec §3.5 and Spotlight', () => {
+    expect(Object.values(LinkResourceProduct)).toEqual([
+      'BEAM',
+      'SPOTLIGHT',
+      'ATLAS',
+      'DRAW',
+      'RETROSPECTIVE',
+      'FORM',
+      'EXTRACT',
+      'CLOUD',
+      'MEMORIES',
+    ]);
+  });
+});
+
+describe('link limits', () => {
+  it('carries the values of the spec', () => {
+    expect(MIN_LINK_PASSWORD_LENGTH).toBe(4);
+    expect(MAX_LINK_PASSWORD_LENGTH).toBe(128);
+    expect(LINK_RESOURCE_CODE_LENGTH).toBe(10);
+    expect(LINK_CAMPAIGN_TOKEN_LENGTH).toBe(12);
+    expect(LINK_CAMPAIGN_TOKENS_PER_PROJECT).toBe(50);
+    expect(CAMPAIGN_TOKEN_QUERY_PARAM).toBe('lnk');
+    expect(LINK_VISIT_RETENTION_DAYS).toBe(90);
+  });
+});

package/src/utils/enum.utils.ts

@@ -0,0 +1 @@
+export type ValueOf<T> = T[keyof T];