@abyss-project/link 0.0.0-stage → 1.0.0

package/dist/types/interface/api/responses/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./abyss.admin.response"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/interface/api/responses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/responses/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}

package/dist/types/interface/api/type-message/api-error.d.ts

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

package/dist/types/interface/api/type-message/api-error.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api-error.js.map

package/dist/types/interface/api/type-message/api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/type-message/api-error.ts"],"names":[],"mappings":""}

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

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

package/dist/types/interface/api/type-message/base-paginate.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-paginate.js.map

package/dist/types/interface/api/type-message/base-paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-paginate.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/type-message/base-paginate.ts"],"names":[],"mappings":""}

package/dist/types/interface/api/type-message/response.d.ts

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

package/dist/types/interface/api/type-message/response.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=response.js.map

package/dist/types/interface/api/type-message/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/type-message/response.ts"],"names":[],"mappings":""}

package/dist/types/interface/index.d.ts

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

package/dist/types/interface/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./models"), exports);
+__exportStar(require("./api"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/interface/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/interface/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,wCAAsB"}

package/dist/types/interface/models/index.d.ts

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

package/dist/types/interface/models/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./user.dto"), exports);
+__exportStar(require("./organization.dto"), exports);
+__exportStar(require("./project.dto"), exports);
+__exportStar(require("./link.dto"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/interface/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/interface/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,qDAAmC;AACnC,gDAA8B;AAC9B,6CAA2B"}

package/dist/types/interface/models/link.dto.d.ts

@@ -0,0 +1,91 @@
+import { LinkKind, LinkResourceProduct, LinkVisitSource } from '../../enum/link.enum';
+import { IOrganization } from './organization.dto';
+import { IProject } from './project.dto';
+import { IUser } from './user.dto';
+export interface ILinkOrigin {
+    service: LinkResourceProduct;
+    resourceType: string;
+    resourceId: string;
+}
+export interface ILink {
+    id: string;
+    kind: LinkKind;
+    slug: string | null;
+    slugKey: string | null;
+    prefix: string | null;
+    code: string | null;
+    token: string | null;
+    targetUrl: string;
+    title: string | null;
+    description: string | null;
+    userId: string | null;
+    projectId: string | null;
+    organizationId: string | null;
+    createdByUserId: string | null;
+    originService: LinkResourceProduct | null;
+    originResourceType: string | null;
+    originResourceId: string | null;
+    isActive: boolean;
+    expiresAt: Date | null;
+    maxClicks: number | null;
+    passwordHash: string | null;
+    forwardCampaignParams: boolean;
+    isProtected: boolean;
+    protectedAt: Date | null;
+    protectedByAdminId: string | null;
+    clickCount: number;
+    uniqueClickCount: number;
+    lastVisitedAt: Date | null;
+    createdAt?: Date;
+    updatedAt?: Date;
+    user?: IUser | null;
+    project?: IProject | null;
+    organization?: IOrganization | null;
+}
+export interface ILinkVisit {
+    id: string;
+    linkId: string;
+    visitedAt: Date;
+    source: LinkVisitSource;
+    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;
+}
+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>;
+}
+export interface ILinkDailyStats extends ILinkBreakdowns {
+    linkId: string;
+    day: string;
+    visits: number;
+    uniqueVisitors: number;
+    botVisits: number;
+}
+export interface ILinkStats extends ILinkBreakdowns {
+    visits: number;
+    uniqueVisitors: number;
+    botVisits: number;
+    lastVisitedAt: Date | null;
+    daily: ILinkDailyStats[];
+}

package/dist/types/interface/models/link.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=link.dto.js.map

package/dist/types/interface/models/link.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/link.dto.ts"],"names":[],"mappings":""}

package/dist/types/interface/models/organization.dto.d.ts

@@ -0,0 +1,11 @@
+import { IProject } from './project.dto';
+export interface IOrganization {
+    id?: string;
+    name: string;
+    slug: string;
+    kind?: 'standard' | 'family';
+    kindSyncedAt?: string | null;
+    updatedAt?: Date;
+    createdAt?: Date;
+    projects?: IProject[];
+}

package/dist/types/interface/models/organization.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=organization.dto.js.map

package/dist/types/interface/models/organization.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/organization.dto.ts"],"names":[],"mappings":""}

package/dist/types/interface/models/project.dto.d.ts

@@ -0,0 +1,12 @@
+import { IOrganization } from './organization.dto';
+import { IUser } from './user.dto';
+export interface IProject {
+    id?: string;
+    name: string;
+    createdByUserId: string | null;
+    organizationId: string;
+    updatedAt?: Date;
+    createdAt?: Date;
+    organization?: IOrganization;
+    user?: IUser;
+}

package/dist/types/interface/models/project.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=project.dto.js.map

package/dist/types/interface/models/project.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/project.dto.ts"],"names":[],"mappings":""}

package/dist/types/interface/models/user.dto.d.ts

@@ -0,0 +1,11 @@
+import { IProject } from './project.dto';
+export interface IUser {
+    id?: string;
+    isAdmin: boolean;
+    personalApiKeyLookupHash?: string | null;
+    personalApiKeyRevokedAt?: Date | null;
+    accountDeletedAt?: Date | null;
+    updatedAt?: Date;
+    createdAt?: Date;
+    projects?: IProject[];
+}

package/dist/types/interface/models/user.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user.dto.js.map

package/dist/types/interface/models/user.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/user.dto.ts"],"names":[],"mappings":""}

package/dist/utils/enum.utils.d.ts

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

package/dist/utils/enum.utils.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=enum.utils.js.map

package/dist/utils/enum.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.utils.js","sourceRoot":"","sources":["../../src/utils/enum.utils.ts"],"names":[],"mappings":""}

package/dist/utils/error.utils.d.ts

@@ -0,0 +1,15 @@
+import { Code, ErrorType } from '../types';
+type ErrorParams = {
+    code: Code;
+    type: ErrorType;
+    message?: string;
+};
+export declare class ServiceException extends Error {
+    private readonly code;
+    private readonly type;
+    getCode(): Code;
+    getType(): ErrorType;
+    constructor(params: ErrorParams);
+}
+export declare const handleError: (error: Error | ErrorParams, _params?: ErrorParams) => Error;
+export {};

package/dist/utils/error.utils.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleError = exports.ServiceException = void 0;
+class ServiceException extends Error {
+    getCode() {
+        return this.code;
+    }
+    getType() {
+        return this.type;
+    }
+    constructor(params) {
+        super(params.message);
+        this.code = params.code;
+        this.type = params.type;
+    }
+}
+exports.ServiceException = ServiceException;
+const handleError = (error, _params) => {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new ServiceException(error);
+};
+exports.handleError = handleError;
+//# sourceMappingURL=error.utils.js.map

package/dist/utils/error.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.utils.js","sourceRoot":"","sources":["../../src/utils/error.utils.ts"],"names":[],"mappings":";;;AAIA,MAAa,gBAAiB,SAAQ,KAAK;IAKzC,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,YAAY,MAAmB;QAC7B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF;AAlBD,4CAkBC;AAEM,MAAM,WAAW,GAAG,CAAC,KAA0B,EAAE,OAAqB,EAAS,EAAE;IACtF,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC,CAAC;AALW,QAAA,WAAW,eAKtB"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './error.utils';
+export * from './enum.utils';
+export * from './link-slug.utils';

package/dist/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./error.utils"), exports);
+__exportStar(require("./enum.utils"), exports);
+__exportStar(require("./link-slug.utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,+CAA6B;AAC7B,oDAAkC"}

package/dist/utils/link-slug.utils.d.ts

@@ -0,0 +1 @@
+export declare const isForbiddenLinkSlug: (slug: string) => boolean;

package/dist/utils/link-slug.utils.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isForbiddenLinkSlug = void 0;
+const link_constants_1 = require("../constants/link.constants");
+const isForbiddenLinkSlug = (slug) => {
+    const key = slug.toLowerCase();
+    return (link_constants_1.LINK_FORBIDDEN_SLUGS.includes(key) ||
+        link_constants_1.LINK_FORBIDDEN_SLUG_PREFIXES.some((prefix) => key.startsWith(prefix)));
+};
+exports.isForbiddenLinkSlug = isForbiddenLinkSlug;
+//# sourceMappingURL=link-slug.utils.js.map

package/dist/utils/link-slug.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-slug.utils.js","sourceRoot":"","sources":["../../src/utils/link-slug.utils.ts"],"names":[],"mappings":";;;AAAA,gEAAiG;AAG1F,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAW,EAAE;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC/B,OAAO,CACL,qCAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC;QAClC,6CAA4B,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B"}

package/jest.config.cjs

@@ -0,0 +1,9 @@
+/** @type {import('jest').Config} */
+module.exports = {
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.tsx?$': 'ts-jest',
+  },
+  testMatch: ['**/tests/**/*.spec.ts'],
+  modulePathIgnorePatterns: ['dist'],
+};

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@abyss-project/link",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Core package to interact with AbyssLink",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/abyss-group/abyss-link.git"
+  },
+  "keywords": [],
+  "author": "scylla",
+  "license": "ISC",
+  "engines": {
+    "node": ">=19.8"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "axios-retry": "^4.5.0",
+    "date-fns": "^2.30.0",
+    "dayjs": "^1.10.7",
+    "jsonwebtoken": "^8.5.1",
+    "reflect-metadata": "^0.1.13",
+    "ts-node": "^10.4.0",
+    "ts-node-dev": "^1.1.1",
+    "uuid": "^8.3.2"
+  },
+  "devDependencies": {
+    "@types/express-serve-static-core": "^4.19.6",
+    "@types/jest": "^29.5.14",
+    "@types/jsonwebtoken": "^8.5.0",
+    "@types/node": "^20.11.0",
+    "@types/uuid": "^8.3.0",
+    "@typescript-eslint/eslint-plugin": "8.71.0",
+    "@typescript-eslint/parser": "8.71.0",
+    "eslint": "^8.57.1",
+    "eslint-config-airbnb-base": "^14.2.1",
+    "eslint-config-prettier": "^8.3.0",
+    "eslint-config-standard": "^16.0.3",
+    "eslint-plugin-filenames-simple": "^0.7.0",
+    "eslint-plugin-import": "^2.23.4",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-prettier": "^3.4.0",
+    "eslint-plugin-promise": "^5.1.0",
+    "jest": "^29.7.0",
+    "prettier": "2.3.1",
+    "ts-jest": "^29.4.15",
+    "tsc-watch": "^4.6.2",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "lint": "eslint \"{src,apps,libs,test,core}/**/*.ts\" --fix",
+    "lint:check": "eslint \"{src,apps,libs,test,core}/**/*.ts\" --max-warnings 0",
+    "tsc": "tsc",
+    "build": "tsc",
+    "test": "jest",
+    "dev": "tsc --watch"
+  }
 }

package/src/api/abyss.admin.api.ts

@@ -0,0 +1,39 @@
+import {
+  AbyssLinkCore,
+  IActivateUserServiceAbyssAdminBody,
+  IActivateUserServiceAbyssAdminResponse,
+  ISyncOrganizationAbyssAdminBody,
+  ISyncOrganizationAbyssAdminResponse,
+  ISyncProjectAbyssAdminBody,
+  ISyncProjectAbyssAdminResponse,
+} from '..';
+
+export const activateUserServiceAbyssAdmin = async (
+  body: IActivateUserServiceAbyssAdminBody,
+): Promise<IActivateUserServiceAbyssAdminResponse> => {
+  return (
+    await AbyssLinkCore.axios.post<IActivateUserServiceAbyssAdminResponse>(
+      `abyss/admin/user/activate-service`,
+      body,
+    )
+  ).data;
+};
+
+export const syncOrganizationAbyssAdmin = async (
+  body: ISyncOrganizationAbyssAdminBody,
+): Promise<ISyncOrganizationAbyssAdminResponse> => {
+  return (
+    await AbyssLinkCore.axios.post<ISyncOrganizationAbyssAdminResponse>(
+      `abyss/admin/organization/sync`,
+      body,
+    )
+  ).data;
+};
+
+export const syncProjectAbyssAdmin = async (
+  body: ISyncProjectAbyssAdminBody,
+): Promise<ISyncProjectAbyssAdminResponse> => {
+  return (
+    await AbyssLinkCore.axios.post<ISyncProjectAbyssAdminResponse>(`abyss/admin/project/sync`, body)
+  ).data;
+};

package/src/api/index.ts

@@ -0,0 +1 @@
+export * from './abyss.admin.api';

package/src/constants/index.ts

@@ -0,0 +1 @@
+export * from './link.constants';

package/src/constants/link.constants.ts

@@ -0,0 +1,49 @@
+import { LinkResourceProduct } from '../types/enum/link.enum';
+
+/** Products that own a RESOURCE address. Spotlight only receives campaign tokens, which have no Link address. */
+export type LinkPrefixedProduct = Exclude<LinkResourceProduct, LinkResourceProduct.SPOTLIGHT>;
+
+/** First segment of a RESOURCE address, `<host>/<prefix>/<code>` (spec §3.5). Compared in lowercase (R10). */
+export const LINK_RESOURCE_PREFIXES: Readonly<Record<LinkPrefixedProduct, string>> = {
+  [LinkResourceProduct.BEAM]: 'b',
+  [LinkResourceProduct.ATLAS]: 'a',
+  [LinkResourceProduct.DRAW]: 'd',
+  [LinkResourceProduct.RETROSPECTIVE]: 'r',
+  [LinkResourceProduct.FORM]: 'f',
+  [LinkResourceProduct.EXTRACT]: 'e',
+  [LinkResourceProduct.CLOUD]: 'c',
+  [LinkResourceProduct.MEMORIES]: 'm',
+};
+
+/** A SHORTENED slug starting with one of these (lowercase) is refused. */
+export const LINK_FORBIDDEN_SLUG_PREFIXES: readonly string[] = ['_', 'abyss'];
+
+/** SHORTENED slugs refused at manual creation, in lowercase: every resource prefix and the host's own paths. */
+export const LINK_FORBIDDEN_SLUGS: readonly string[] = [
+  ...Object.values(LINK_RESOURCE_PREFIXES),
+  'api',
+  'assets',
+  'static',
+  'health',
+  'admin',
+  'login',
+  'favicon.ico',
+  'robots.txt',
+  '.well-known',
+];
+
+export const MIN_LINK_SLUG_LENGTH = 3;
+export const MAX_LINK_SLUG_LENGTH = 50;
+export const LINK_SLUG_PATTERN = /^[a-zA-Z0-9_-]{3,50}$/;
+
+export const MIN_LINK_PASSWORD_LENGTH = 4;
+export const MAX_LINK_PASSWORD_LENGTH = 128;
+
+/** Base62 code of a RESOURCE address, compared exactly (R10). */
+export const LINK_RESOURCE_CODE_LENGTH = 10;
+/** Base62 campaign token. */
+export const LINK_CAMPAIGN_TOKEN_LENGTH = 12;
+export const LINK_CAMPAIGN_TOKENS_PER_PROJECT = 50;
+
+/** Raw visits are kept this long (O2); daily aggregates live as long as the link. */
+export const LINK_VISIT_RETENTION_DAYS = 90;