@intlayer/api 9.5.0 → 9.5.2

package/dist/types/apps/backend/dist/types/types/analytics.types.d.ts

@@ -0,0 +1,128 @@
+import "../utils/mongoDB/types.js";
+import { Document, Types } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+//#region ../../../apps/backend/dist/types/types/analytics.types.d.ts
+//#region src/types/analytics.types.d.ts
+/**
+ * The kind of signal an ingested analytics event carries. Mirrors the wire
+ * contract emitted by `@intlayer/analytics`.
+ */
+export type AnalyticsEventType = 'page_view' | 'content_exposure' | 'conversion';
+/**
+ * A single event as sent by the client SDK (short keys keep the payload small).
+ */
+export type IncomingAnalyticsEvent = {
+  type: AnalyticsEventType;
+  /** Client timestamp (ms since epoch). */
+  t: number;
+  /** Current locale being displayed. */
+  locale: string;
+  /** Page pathname. */
+  url: string;
+  /** Referrer host (page views). */
+  ref?: string;
+  /** Dictionary key (content exposures). */
+  dictionaryKey?: string;
+  /** Serialized key path (content exposures). */
+  keyPath?: string;
+  /** Interpreter node type (content exposures). */
+  nodeType?: string;
+  /** A/B variant (content exposures + conversions). */
+  variant?: string;
+  /** Coalesced exposure count. */
+  count?: number;
+  /** Experiment key (conversions). */
+  experimentKey?: string;
+  /** Conversion goal name. */
+  goal?: string;
+  /** Optional numeric conversion value. */
+  value?: number;
+};
+/** Selectable rolling windows for the audience report. */
+export type AudienceRange = '1h' | '24h' | '7d' | '30d' | '90d' | '6mo' | '1y' | '3y';
+/**
+ * Bucket size of the evolution series. Derived from the requested range so a
+ * three-year window does not return a thousand daily points.
+ */
+export type AudienceGranularity = 'minute' | 'hour' | 'day' | 'week' | 'month';
+/** One point of the audience evolution series. */
+export type AudienceSeriesPoint = {
+  /**
+   * UTC start of the bucket. `YYYY-MM-DDTHH:mm` for the `minute` and `hour`
+   * granularities, `YYYY-MM-DD` for `day`, `week`, and `month`.
+   */
+  bucket: string;
+  /** Distinct visitors first seen in this bucket. */
+  users: number;
+  /** Page views in this bucket. */
+  views: number;
+};
+/** A ranked audience breakdown row (by locale, by country, or by page). */
+export type AudienceBreakdownRow = {
+  /** The locale code, country code, or page pathname. */
+  key: string;
+  /** Distinct visitors for this bucket. */
+  users: number;
+  /** Page views for this bucket. */
+  views: number;
+};
+/** The full audience report backing the dashboard overview. */
+export type AudienceStats = {
+  /** Distinct visitors today (UTC). */
+  usersToday: number;
+  /** Distinct visitors over the last 7 days. */
+  usersLast7Days: number;
+  /** Distinct visitors over the requested window. */
+  usersInRange: number;
+  /** Page views over the requested window. */
+  viewsInRange: number;
+  /** The window this report covers. */
+  range: AudienceRange;
+  /** Number of hours covered by the window. */
+  rangeHours: number;
+  /** Bucket size of `series`. */
+  granularity: AudienceGranularity;
+  /** Evolution over the requested window, oldest bucket first. */
+  series: AudienceSeriesPoint[];
+  /** Most-consulted locales, highest first. */
+  byLocale: AudienceBreakdownRow[];
+  /** Visitor location breakdown, highest first. */
+  byCountry: AudienceBreakdownRow[];
+  /**
+   * Most-consulted pages, highest first. Keyed by pathname, so a localized
+   * route contributes one row per locale prefix (`/en/pricing`, `/fr/pricing`).
+   * Visitors are not attributed per page — only `views` is populated.
+   */
+  byPage: AudienceBreakdownRow[];
+};
+/** Aggregated page/locale totals for the dashboard overview. */
+export type AnalyticsOverviewRow = {
+  url: string;
+  locale: string;
+  views: number;
+};
+/** Aggregated per-content exposure totals. */
+export type ContentStatRow = {
+  dictionaryKey: string;
+  keyPath: string;
+  locale: string;
+  exposures: number;
+};
+/** Per-variant A/B result with significance. */
+export type ExperimentVariantResult = {
+  variant: string;
+  exposures: number;
+  conversions: number;
+  conversionRate: number;
+};
+/** Full A/B experiment result set. */
+export type ExperimentResult = {
+  experimentKey: string;
+  variants: ExperimentVariantResult[];
+  /** Two-proportion z-test p-value of the best variant vs. the control. */
+  pValue: number | null;
+  /** The best-performing variant, when there is enough data to pick one. */
+  winner: string | null;
+};
+//#endregion
+//#endregion
+//# sourceMappingURL=analytics.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/analytics.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/analytics.types.d.ts"],"mappings":";;;;;;;;YAOY;;;;YAIA;EACV,MAAM;;EAEN;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;YAgFU;;;;;YAKA;;YAEA;;;;;EAKV;;EAEA;;EAEA;;;YAGU;;EAEV;;EAEA;;EAEA;;;YAGU;;EAEV;;EAEA;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;;EAEA,aAAa;;EAEb,QAAQ;;EAER,UAAU;;EAEV,WAAW;;;;;;EAMX,QAAQ;;;YAGE;EACV;EACA;EACA;;;YAGU;EACV;EACA;EACA;EACA;;;YAGU;EACV;EACA;EACA;EACA;;;YAGU;EACV;EACA,UAAU;;EAEV;;EAEA"}

package/dist/types/apps/backend/dist/types/types/asset.types.d.ts

@@ -0,0 +1,30 @@
+import "../utils/mongoDB/types.js";
+import { Document, ObjectIdToString, Types } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+//#region ../../../apps/backend/dist/types/types/asset.types.d.ts
+//#region src/types/asset.types.d.ts
+export interface Asset extends Document {
+  id: Types.ObjectId;
+  /** Project this asset belongs to. */
+  projectId: Types.ObjectId;
+  /** Original file name as provided by the uploader. */
+  originalName: string;
+  /** MIME type (e.g. "image/jpeg"). */
+  mimeType: string;
+  /** File size in bytes. */
+  size: number;
+  /** S3 object key (used for deletion). */
+  s3Key: string;
+  /** Publicly accessible CDN URL. */
+  publicUrl: string;
+  /** Optional alt text for accessibility. */
+  alt?: string;
+  /** Optional caption displayed below the image. */
+  caption?: string;
+  /** User who uploaded the asset. */
+  uploadedBy: Types.ObjectId;
+  createdAt: Date;
+  updatedAt: Date;
+}
+export type AssetAPI = ObjectIdToString<Asset>;
+//#endregion
+//# sourceMappingURL=asset.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/asset.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/asset.types.d.ts"],"mappings":";;;;iBAGiB,cAAc;EAC7B,IAAI,MAAM;;EAEV,WAAW,MAAM;;EAEjB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,YAAY,MAAM;EAClB,WAAW;EACX,WAAW;;YAED,WAAW,iBAAiB"}

package/dist/types/apps/backend/dist/types/types/dictionary.types.d.ts

@@ -0,0 +1,67 @@
+import "../utils/mongoDB/types.js";
+import { User } from "./user.types.js";
+import { Project } from "./project.types.js";
+import { Document, ObjectIdToString, Types } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+import { ContentNode, Dictionary } from "@intlayer/types/dictionary";
+//#region ../../../apps/backend/dist/types/types/dictionary.types.d.ts
+//#region src/types/dictionary.types.d.ts
+/**
+ * Qualifier coordinates of a dictionary (collections / variants).
+ *
+ * Pushed dictionaries are unmerged: sibling declarations sharing a `key` are
+ * distinguished by these coordinates. Persisting them lets the build re-merge
+ * remote dictionaries into a `QualifiedDictionaryGroup` on pull. A plain
+ * dictionary leaves all of them undefined.
+ */
+export type DictionaryQualifiers = {
+  /**
+   * Variant discriminator — a named string (A/B testing, seasonal banners…) or
+   * a structured object (CMS records, user-specific copy…).
+   */
+  variant?: string | Record<string, string | number>;
+  /** Ordered collection item index. */
+  item?: number;
+};
+export type DictionaryCreationData = DictionaryQualifiers & {
+  projectIds: (Project['id'] | string)[];
+  key: string;
+  content?: ContentNode;
+  title?: string;
+  description?: string;
+  priority?: number;
+  importMode?: 'static' | 'dynamic' | 'fetch';
+  tags?: string[];
+  environmentId?: string;
+};
+export type VersionedContentEl = {
+  name?: string;
+  description?: string;
+  content: ContentNode;
+};
+export type VersionedContent = Map<string, VersionedContentEl>;
+export type DictionaryData = DictionaryQualifiers & {
+  key: string;
+  content: VersionedContent;
+  projectIds: (Project['id'] | string)[];
+  creatorId: User['id'];
+  title?: string;
+  description?: string;
+  priority?: number;
+  importMode?: 'static' | 'dynamic' | 'fetch';
+  tags?: string[];
+  /** If set, this dictionary belongs to a specific project environment. Null means shared (visible in all envs). */
+  environmentId?: Types.ObjectId | string | null;
+};
+type Dictionary$1 = DictionaryData & {
+  id: Types.ObjectId;
+  createdAt: number;
+  updatedAt: number;
+};
+export type DictionaryAPI = ObjectIdToString<Dictionary & {
+  projectIds: (Project['id'] | string)[];
+  updatedAt: number;
+  createdAt: number;
+}>;
+//#endregion
+export { Dictionary$1 as Dictionary };
+//# sourceMappingURL=dictionary.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/dictionary.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/dictionary.types.d.ts"],"mappings":";;;;;;;;;;;;;;;YAcY;;;;;EAKV,mBAAmB;;EAEnB;;YAEU,yBAAyB;EACnC,aAAa;EACb;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;;YAEU;EACV;EACA;EACA,SAAS;;YAGC,mBAAmB,YAAY;YAC/B,iBAAiB;EAC3B;EACA,SAAS;EACT,aAAa;EACb,WAAW;EACX;EACA;EACA;EACA;EACA;;EAEA,gBAAgB,MAAM;;KAEZ,eAAa;EACvB,IAAI,MAAM;EACV;EACA;;YAEU,gBAAgB,iBAAiB;EAC3C,aAAa;EACb;EACA"}

package/dist/types/apps/backend/dist/types/types/discussion.types.d.ts

@@ -0,0 +1,41 @@
+import "../utils/mongoDB/types.js";
+import { Document, ObjectIdToString, Types } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+//#region ../../../apps/backend/dist/types/types/discussion.types.d.ts
+//#region src/types/discussion.types.d.ts
+export interface Message {
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+  relatedFiles?: string[];
+  timestamp: Date;
+}
+export type DiscussionType = 'doc' | 'dashboard';
+export interface TokenUsage {
+  /** Tokens consumed by the input/prompt. */
+  inputTokens: number;
+  /** Tokens produced in the model output. */
+  outputTokens: number;
+  /** Sum of inputTokens and outputTokens. */
+  totalTokens: number;
+}
+export interface Discussion extends Document {
+  id: Types.ObjectId;
+  discussionId: string;
+  messages: Message[];
+  userId?: Types.ObjectId;
+  projectId?: Types.ObjectId;
+  organizationId?: Types.ObjectId;
+  title?: string;
+  type?: DiscussionType;
+  isArchived: boolean;
+  /** AI model identifier used for the last completion in this discussion. */
+  aiModel?: string;
+  /** Token consumption recorded for the last AI call in this discussion. */
+  tokenUsage?: TokenUsage;
+  createdAt: Date;
+  updatedAt: Date;
+}
+export type DiscussionAPI = ObjectIdToString<Discussion & {
+  numberOfMessages: number;
+}>;
+//#endregion
+//# sourceMappingURL=discussion.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/discussion.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussion.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/discussion.types.d.ts"],"mappings":";;;;iBAGiB;EACf;EACA;EACA;EACA,WAAW;;YAED;iBACK;;EAEf;;EAEA;;EAEA;;iBAEe,mBAAmB;EAClC,IAAI,MAAM;EACV;EACA,UAAU;EACV,SAAS,MAAM;EACf,YAAY,MAAM;EAClB,iBAAiB,MAAM;EACvB;EACA,OAAO;EACP;;EAEA;;EAEA,aAAa;EACb,WAAW;EACX,WAAW;;YAED,gBAAgB,iBAAiB;EAC3C"}

package/dist/types/apps/backend/dist/types/types/oAuth2.types.d.ts

@@ -0,0 +1,14 @@
+import { UserAPI } from "./user.types.js";
+import { OrganizationAPI } from "./organization.types.js";
+import { ProjectAPI } from "./project.types.js";
+import { Document } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+import { Token } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/@node-oauth+oauth2-server@5.3.0/node_modules/@node-oauth/oauth2-server/index.js";
+//#region ../../../apps/backend/dist/types/types/oAuth2.types.d.ts
+//#region src/types/oAuth2.types.d.ts
+export type OAuth2Token = Token & {
+  organization: OrganizationAPI;
+  project: ProjectAPI;
+  user: UserAPI;
+};
+//#endregion
+//# sourceMappingURL=oAuth2.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/oAuth2.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oAuth2.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/oAuth2.types.d.ts"],"mappings":";;;;;;;YAMY,cAAc;EACxB,cAAc;EACd,SAAS;EACT,MAAM"}

package/dist/types/apps/backend/dist/types/types/organization.types.d.ts

@@ -0,0 +1,105 @@
+import "../utils/mongoDB/types.js";
+import { User } from "./user.types.js";
+import { Plan } from "./plan.types.js";
+import { Document, ObjectIdToString, Types } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+//#region ../../../apps/backend/dist/types/types/organization.types.d.ts
+//#region src/types/organization.types.d.ts
+/**
+ * Note: SSO configuration is managed entirely by better-auth's SSO plugin.
+ * The organization only stores a reference to whether SSO is enabled
+ * and the domain for SSO provider lookup.
+ * See: https://www.better-auth.com/docs/plugins/sso
+ */
+export type OrganizationCreationData = {
+  name: Organization['name'];
+};
+/** Supported transactional email providers for a per-organization mailer. */
+export type MailerProvider = 'resend' | 'smtp';
+/**
+ * Per-organization mailer configuration.
+ *
+ * The same shape is used both for the stored document and for API responses,
+ * which keeps `Organization` structurally assignable to `OrganizationAPI`.
+ * The two representations differ only in which optional fields are populated:
+ *
+ * - Stored: secrets (`resend.apiKey`, `smtp.password`) hold the encrypted value
+ *   (see `@utils/crypto/encryption`); the `has*` flags are absent.
+ * - API: `mapOrganizationToAPI` strips the secrets and sets the `has*` flags so
+ *   the dashboard can indicate that a value is configured without exposing it.
+ */
+export type OrganizationMailerConfig = {
+  /** Whether org-scoped emails should use this mailer instead of the default. */
+  isActive: boolean;
+  /** Which provider to send through. */
+  provider: MailerProvider;
+  /** Display name used in the `From` header (e.g. "Acme"). */
+  fromName?: string;
+  /** Sender address used in the `From` header (e.g. "no-reply@acme.com"). */
+  fromEmail?: string;
+  /** Resend-specific settings. */
+  resend?: {
+    /** Encrypted API key. Present only on the stored document, never in API responses. */
+    apiKey?: string;
+    /** API-only flag: whether a Resend API key is currently stored. */
+    hasApiKey?: boolean;
+  };
+  /** SMTP-specific settings. */
+  smtp?: {
+    host?: string;
+    port?: number;
+    /** Whether to use an implicit TLS connection (usually port 465). */
+    secure?: boolean;
+    user?: string;
+    /** Encrypted password. Present only on the stored document, never in API responses. */
+    password?: string;
+    /** API-only flag: whether an SMTP password is currently stored. */
+    hasPassword?: boolean;
+  };
+};
+/**
+ * Payload accepted when updating a mailer configuration.
+ *
+ * Secrets are plaintext and optional: an omitted or empty secret means "keep
+ * the value already stored", so the dashboard never has to round-trip it.
+ */
+export type OrganizationMailerConfigInput = {
+  isActive: boolean;
+  provider: MailerProvider;
+  fromName?: string;
+  fromEmail?: string;
+  resend?: {
+    apiKey?: string;
+  };
+  smtp?: {
+    host?: string;
+    port?: number;
+    secure?: boolean;
+    user?: string;
+    password?: string;
+  };
+};
+export type OrganizationData = {
+  name: string;
+  membersIds: User['id'][];
+  adminsIds: User['id'][];
+  /** Whether SSO is configured for this organization (managed by better-auth) */
+  ssoEnabled: boolean;
+  /** Primary domain for this organization (used for SSO provider lookup) */
+  domain: string;
+  /**
+   * Optional per-organization transactional mailer. When active, org-scoped
+   * emails (invites, access keys, reviewer, subscription…) are sent through it.
+   * Secrets are stored encrypted; see {@link OrganizationMailerConfig}.
+   */
+  mailerConfig?: OrganizationMailerConfig;
+};
+export type Organization = OrganizationData & {
+  id: Types.ObjectId;
+  creatorId: User['id'];
+  plan?: Plan;
+  createdAt: number;
+  updatedAt: number;
+};
+export type OrganizationAPI = ObjectIdToString<Organization>;
+//#endregion
+//# sourceMappingURL=organization.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/organization.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/organization.types.d.ts"],"mappings":";;;;;;;;;;;;YAWY;EACV,MAAM;;;YAGI;;;;;;;;;;;;;YAaA;;EAEV;;EAEA,UAAU;;EAEV;;EAEA;;EAEA;;IAEE;;IAEA;;;EAGF;IACE;IACA;;IAEA;IACA;;IAEA;;IAEA;;;;;;;;;YAeQ;EACV;EACA,UAAU;EACV;EACA;EACA;IACE;;EAEF;IACE;IACA;IACA;IACA;IACA;;;YAGQ;EACV;EACA,YAAY;EACZ,WAAW;;EAEX;;EAEA;;;;;;EAMA,eAAe;;YAEL,eAAe;EACzB,IAAI,MAAM;EACV,WAAW;EACX,OAAO;EACP;EACA;;YAEU,kBAAkB,iBAAiB"}

package/dist/types/apps/backend/dist/types/types/plan.types.d.ts

@@ -0,0 +1,22 @@
+import "../utils/mongoDB/types.js";
+import { User } from "./user.types.js";
+import { Document, ObjectIdToString, Types } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+//#region ../../../apps/backend/dist/types/types/plan.types.d.ts
+//#region src/types/plan.types.d.ts
+export type PlanType = 'FREE' | 'PREMIUM' | 'ENTERPRISE' | 'LIFETIME';
+export type PlanData = {
+  type: PlanType;
+  creatorId?: User['id'];
+  subscriptionId?: string;
+  customerId?: string;
+  priceId?: string;
+  status?: 'active' | 'canceled' | 'past_due' | 'unpaid' | 'incomplete' | 'incomplete_expired' | 'paused' | 'trialing';
+  period?: 'MONTHLY' | 'YEARLY' | 'LIFETIME';
+};
+export type Plan = PlanData & {
+  id: Types.ObjectId;
+  createdAt: number;
+  updatedAt: number;
+};
+//#endregion
+//# sourceMappingURL=plan.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/plan.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/plan.types.d.ts"],"mappings":";;;;;YAIY;YACA;EACV,MAAM;EACN,YAAY;EACZ;EACA;EACA;EACA;EACA;;YAEU,OAAO;EACjB,IAAI,MAAM;EACV;EACA"}

package/dist/types/apps/backend/dist/types/types/project.types.d.ts

@@ -0,0 +1,127 @@
+import "../utils/mongoDB/types.js";
+import { User } from "./user.types.js";
+import { Organization } from "./organization.types.js";
+import { IntlayerConfig } from "@intlayer/types/config";
+import { Document, ObjectIdToString, Types } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/mongoose@9.10.0+7f93886e57f5bac2/node_modules/mongoose/index.js";
+import { Locale } from "@intlayer/types/allLocales";
+import { Token } from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/@node-oauth+oauth2-server@5.3.0/node_modules/@node-oauth/oauth2-server/index.js";
+//#region ../../../apps/backend/dist/types/types/project.types.d.ts
+//#region src/types/project.types.d.ts
+export type ProjectCreationData = {
+  name: Project['name'];
+};
+export type EnvironmentData = {
+  name: string;
+  isDefault: boolean;
+  configuration?: ProjectConfiguration;
+};
+export type Environment = EnvironmentData & {
+  id: Types.ObjectId;
+  createdAt: number;
+  updatedAt: number;
+};
+export type EnvironmentAPI = ObjectIdToString<Environment>;
+type ProjectConfigInternationalization = Partial<Pick<IntlayerConfig['internationalization'], 'locales' | 'defaultLocale'>>;
+type ProjectConfigEditor = Partial<Pick<IntlayerConfig['editor'], 'applicationURL' | 'cmsURL'>>;
+type ProjectConfigAI = Partial<IntlayerConfig['ai']> & {
+  apiKey?: string;
+  apiKeyConfigured?: boolean;
+};
+export type Webhook = {
+  id?: string;
+  name: string;
+  url: string;
+  enabled: boolean;
+  secret?: string;
+};
+export type ProjectConfigCI = {
+  autoTriggerBuilds?: boolean;
+  webhooks?: Webhook[];
+};
+export type ProjectConfiguration = {
+  internationalization?: ProjectConfigInternationalization;
+  editor?: ProjectConfigEditor;
+  ai?: ProjectConfigAI;
+};
+export type RepositoryProvider = 'github' | 'gitlab' | 'bitbucket';
+export type BaseRepository = {
+  provider: RepositoryProvider;
+  owner: string;
+  repository: string;
+  branch: string;
+  url: string;
+  configFilePath: string;
+  /** Repo-scoped OAuth token used for CI operations (write access to the repo) */
+  token?: string;
+};
+export type GitHubRepository = BaseRepository & {
+  provider: 'github';
+  installationId?: number;
+};
+export type GitLabRepository = BaseRepository & {
+  provider: 'gitlab';
+  projectId?: number;
+  /** Custom GitLab instance URL (e.g., https://gitlab.company.com) */
+  instanceUrl?: string;
+};
+export type BitbucketRepository = BaseRepository & {
+  provider: 'bitbucket';
+  workspace: string;
+};
+export type RepositoryConnection = GitHubRepository | GitLabRepository | BitbucketRepository;
+export type ProjectData = {
+  organizationId: Organization['id'];
+  name: string;
+  membersIds: User['id'][];
+  adminsIds: User['id'][];
+  viewersIds?: User['id'][];
+  /** Granular per-member access constraints, additive overlay on the role system. */
+  memberAccess?: ProjectMemberGranularAccess[];
+  creatorId: User['id'];
+  configuration?: ProjectConfiguration;
+  repository?: RepositoryConnection;
+  webhooks?: ProjectConfigCI;
+  autoFill?: boolean;
+  /** Screenshot of the application URL, generated automatically when applicationURL is set */
+  imageUrl?: string;
+  environments?: Environment[];
+};
+export type AccessKeyData = {
+  name: string;
+  grants: string[];
+  expiresAt?: Date;
+  /** null = unrestricted (all environments). null item in array = production env. */
+  allowedEnvironmentIds?: (string | null)[] | null;
+  /** null = unrestricted (all locales). */
+  allowedLocales?: Locale[] | null;
+};
+export type OAuth2AccessData = AccessKeyData & {
+  clientId: string;
+  clientSecret: string;
+  accessToken: string[];
+  userId: User['id'];
+};
+/**
+ * Granular per-member access constraints, overlaid on top of the member's role.
+ * null = unrestricted; [] = no access; array = restricted to listed items.
+ */
+export type ProjectMemberGranularAccess = {
+  userId: Types.ObjectId;
+  allowedEnvironmentIds: (Types.ObjectId | null)[] | null;
+  allowedLocales: Locale[] | null;
+};
+export type ProjectMemberGranularAccessAPI = ObjectIdToString<ProjectMemberGranularAccess>;
+export type OAuth2Access = OAuth2AccessData & {
+  id: Types.ObjectId;
+  createdAt: number;
+  updatedAt: number;
+};
+export type Project = ProjectData & {
+  id: Types.ObjectId;
+  createdAt: number;
+  updatedAt: number;
+  oAuth2Access: OAuth2Access[];
+};
+export type ProjectAPI = ObjectIdToString<Project>;
+//#endregion
+//# sourceMappingURL=project.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/project.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/project.types.d.ts"],"mappings":";;;;;;;;;YAQY;EACV,MAAM;;YAEI;EACV;EACA;EACA,gBAAgB;;YAEN,cAAc;EACxB,IAAI,MAAM;EACV;EACA;;YAEU,iBAAiB,iBAAiB;KACzC,oCAAoC,QAAQ,KAAK;KACjD,sBAAsB,QAAQ,KAAK;KACnC,kBAAkB,QAAQ;EAC7B;EACA;;YAEU;EACV;EACA;EACA;EACA;EACA;;YAEU;EACV;EACA,WAAW;;YAED;EACV,uBAAuB;EACvB,SAAS;EACT,KAAK;;YAEK;YACA;EACV,UAAU;EACV;EACA;EACA;EACA;EACA;;EAEA;;YAEU,mBAAmB;EAC7B;EACA;;YAEU,mBAAmB;EAC7B;EACA;;EAEA;;YAEU,sBAAsB;EAChC;EACA;;YAEU,uBAAuB,mBAAmB,mBAAmB;YAC7D;EACV,gBAAgB;EAChB;EACA,YAAY;EACZ,WAAW;EACX,aAAa;;EAEb,eAAe;EACf,WAAW;EACX,gBAAgB;EAChB,aAAa;EACb,WAAW;EACX;;EAEA;EACA,eAAe;;YAEL;EACV;EACA;EACA,YAAY;;EAEZ;;EAEA,iBAAiB;;YAEP,mBAAmB;EAC7B;EACA;EACA;EACA,QAAQ;;;;;;YAeE;EACV,QAAQ,MAAM;EACd,wBAAwB,MAAM;EAC9B,gBAAgB;;YAEN,iCAAiC,iBAAiB;YAClD,eAAe;EACzB,IAAI,MAAM;EACV;EACA;;YAGU,UAAU;EACpB,IAAI,MAAM;EACV;EACA;EACA,cAAc;;YAEJ,aAAa,iBAAiB"}

package/dist/types/apps/backend/dist/types/types/projectInsights.types.d.ts

@@ -0,0 +1,79 @@
+import { RepositoryProvider } from "./project.types.js";
+import { Locale } from "@intlayer/types/allLocales";
+//#region ../../../apps/backend/dist/types/types/projectInsights.types.d.ts
+//#region src/types/projectInsights.types.d.ts
+/**
+ * Translation health for a single locale of a project, computed at key
+ * (translation-node) granularity.
+ */
+export type LocaleInsight = {
+  /** The locale code (e.g. `en`, `fr`). */
+  locale: Locale;
+  /** Whether this is the project's default (source) locale. */
+  isDefault: boolean;
+  /** Number of keys that have a non-empty value for this locale. */
+  translatedKeys: number;
+  /** Total number of keys in the project. */
+  totalKeys: number;
+  /** Keys still missing a value for this locale (`totalKeys - translatedKeys`). */
+  missingKeys: number;
+  /** Completion ratio in the `[0, 1]` range (`translatedKeys / totalKeys`). */
+  completionRate: number;
+};
+/**
+ * Aggregated, project-wide localization insights surfaced on the dashboard
+ * overview page. Computed server-side from the project configuration and the
+ * latest content of every dictionary attached to the project.
+ */
+export type ProjectInsights = {
+  /** The project the insights were computed for. */
+  projectId: string;
+  /** Unix epoch (ms) at which the snapshot was computed. */
+  generatedAt: number;
+  /** The project's default (source) locale, or `null` when not configured. */
+  defaultLocale: Locale | null;
+  /** Number of locales configured for the project. */
+  localeCount: number;
+  /** Number of dictionaries attached to the project. */
+  dictionaryCount: number;
+  /** Total number of translatable keys (translation nodes) across dictionaries. */
+  keyCount: number;
+  /** Target translation units: `keyCount × (number of non-default locales)`. */
+  translationUnitCount: number;
+  /** Translation units (non-default locales) that are filled. */
+  translatedUnitCount: number;
+  /** Overall completion ratio in the `[0, 1]` range. */
+  overallCompletionRate: number;
+  /** Number of locales that are 100% translated. */
+  fullyTranslatedLocaleCount: number;
+  /** Number of dictionaries missing at least one translation. */
+  dictionariesWithMissingTranslations: number;
+  /** Total missing translation units across all non-default locales. */
+  missingTranslationCount: number;
+  /** Per-locale completion breakdown (ordered with the default locale first). */
+  localeInsights: LocaleInsight[];
+  /** Most recently updated dictionaries (key + timestamp), newest first. */
+  recentlyUpdated: {
+    key: string;
+    updatedAt: number;
+  }[];
+  /** Timestamp of the most recently updated dictionary, or `null` when none. */
+  lastUpdatedAt: number | null;
+  /** Number of members on the project. */
+  memberCount: number;
+  /** Number of admins on the project. */
+  adminCount: number;
+  /** Number of environments configured for the project. */
+  environmentCount: number;
+  /** Whether auto-fill (auto-translation on push) is enabled. */
+  autoFill: boolean;
+  /** Whether an AI provider/API key is configured for the project. */
+  aiConfigured: boolean;
+  /** Connected git provider, or `null` when no repository is linked. */
+  repositoryProvider: RepositoryProvider | null;
+  /** The configured application URL (enables the scanner), or `null`. */
+  applicationURL: string | null;
+};
+//#endregion
+//#endregion
+//# sourceMappingURL=projectInsights.types.d.ts.map

package/dist/types/apps/backend/dist/types/types/projectInsights.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectInsights.types.d.ts","names":[],"sources":["../../../../../../../../../../apps/backend/dist/types/types/projectInsights.types.d.ts"],"mappings":";;;;;;;;YAOY;;EAEV,QAAQ;;EAER;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;YAOU;;EAEV;;EAEA;;EAEA,eAAe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,gBAAgB;;EAEhB;IACE;IACA;;;EAGF;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,oBAAoB;;EAEpB"}