@intlayer/backend-contract 9.7.2 → 9.8.0-canary.0

package/dist/cjs/project.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"project.cjs","names":["typedStringSchema","z","typedValueSchema","dateTimeSchema","objectIdSchema","defineRouteGroup","defineRoute","paginationQueryShape","repeatableQueryValueSchema","paginatedResponseSchema","responseDataSchema"],"sources":["../../src/project.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { AiConfig, URLType } from '@intlayer/types/config';\nimport { z } from 'zod/mini';\nimport {\n  dateTimeSchema,\n  objectIdSchema,\n  paginationQueryShape,\n  repeatableQueryValueSchema,\n  typedStringSchema,\n  typedValueSchema,\n} from './common';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBody,\n  type RouteBodyInput,\n  type RouteParams,\n  type RouteQuerystring,\n} from './defineRoute';\nimport {\n  type PaginatedResponse,\n  paginatedResponseSchema,\n  type ResponseData,\n  responseDataSchema,\n} from './responseData';\n\n/** Locale code (ex: `en`, `fr-CA`). */\nexport const localeSchema = typedStringSchema<Locale>();\n\n/** Project AI settings: the Intlayer AI config plus the masked key state. */\nexport type ProjectConfigAI = Partial<AiConfig> & {\n  /** Masked API key (`sk-proj-****abcd`), never the real one. */\n  apiKey?: string;\n  apiKeyConfigured?: boolean;\n};\n\n/**\n * Project-level overrides of the Intlayer configuration. Loose objects: the\n * CLI pushes whole config sections, unknown keys must reach the service.\n */\nexport const projectConfigurationSchema = z.looseObject({\n  internationalization: z.optional(\n    z.looseObject({\n      locales: z.optional(z.array(localeSchema)),\n      defaultLocale: z.optional(localeSchema),\n    })\n  ),\n  editor: z.optional(\n    z.looseObject({\n      applicationURL: z.optional(typedStringSchema<URLType>()),\n      cmsURL: z.optional(typedStringSchema<URLType>()),\n    })\n  ),\n  ai: z.optional(typedValueSchema<ProjectConfigAI>()),\n});\n\n/** Generic build webhook (Vercel, Netlify, custom). */\nexport const webhookSchema = z.looseObject({\n  id: z.optional(z.string()),\n  name: z.string(),\n  url: z.string(),\n  enabled: z.optional(z.boolean()),\n  /** Optional signature secret. */\n  secret: z.optional(z.string()),\n});\n\n/** Build triggers: git provider pipeline + generic webhooks. */\nexport const projectCISchema = z.object({\n  autoTriggerBuilds: z.optional(z.boolean()),\n  /** Commit CMS edits of `hybrid` dictionaries back to their source file. */\n  autoCommitDictionaries: z.optional(z.boolean()),\n  webhooks: z.optional(z.array(webhookSchema)),\n});\n\n/** Git provider of a connected repository. */\nexport const repositoryProviderSchema = z.enum([\n  'github',\n  'gitlab',\n  'bitbucket',\n  'codeberg',\n  'gitee',\n]);\n\nconst baseRepositoryShape = {\n  owner: z.string(),\n  repository: z.string(),\n  branch: z.string(),\n  url: z.string(),\n  configFilePath: z.string(),\n};\n\n/**\n * Git repository connected to a project. The repo-scoped token never leaves\n * the server.\n */\nexport const repositoryConnectionSchema = z.discriminatedUnion('provider', [\n  z.looseObject({\n    provider: z.literal('github'),\n    ...baseRepositoryShape,\n    installationId: z.optional(z.number()),\n  }),\n  z.looseObject({\n    provider: z.literal('gitlab'),\n    ...baseRepositoryShape,\n    projectId: z.optional(z.number()),\n    /** Custom GitLab instance URL (ex: https://gitlab.company.com). */\n    instanceUrl: z.optional(z.string()),\n  }),\n  z.looseObject({\n    provider: z.literal('bitbucket'),\n    ...baseRepositoryShape,\n    workspace: z.string(),\n  }),\n  z.looseObject({ provider: z.literal('codeberg'), ...baseRepositoryShape }),\n  z.looseObject({ provider: z.literal('gitee'), ...baseRepositoryShape }),\n]);\n\n/** null = unrestricted, [] = no access, array = allowed ids (null = production). */\nconst allowedEnvironmentIdsSchema = z.nullable(z.array(z.nullable(z.string())));\n/** null = unrestricted, [] = no access, array = allowed locales. */\nconst allowedLocalesSchema = z.nullable(z.array(localeSchema));\n\n/** Project environment (production is injected when none is the default). */\nexport const environmentSchema = z.looseObject({\n  id: z.string(),\n  name: z.string(),\n  isDefault: z.boolean(),\n  configuration: z.optional(projectConfigurationSchema),\n  createdAt: z.optional(dateTimeSchema),\n  updatedAt: z.optional(dateTimeSchema),\n});\n\n/** Granular per-member access, overlaid on the member's role. */\nexport const projectMemberGranularAccessSchema = z.object({\n  userId: z.string(),\n  allowedEnvironmentIds: allowedEnvironmentIdsSchema,\n  allowedLocales: allowedLocalesSchema,\n});\n\n/** Access key (OAuth2 client credentials). Live bearer tokens are never sent. */\nexport const accessKeySchema = z.looseObject({\n  id: z.string(),\n  name: z.string(),\n  clientId: z.string(),\n  /** Shown to project members (dashboard copy, CLI login). */\n  clientSecret: z.string(),\n  grants: z.array(z.string()),\n  userId: z.string(),\n  expiresAt: z.optional(z.nullable(dateTimeSchema)),\n  allowedEnvironmentIds: z.optional(allowedEnvironmentIdsSchema),\n  allowedLocales: z.optional(allowedLocalesSchema),\n  createdAt: dateTimeSchema,\n  updatedAt: dateTimeSchema,\n});\n\n/** Project as returned by the API. */\nexport const projectSchema = z.looseObject({\n  id: z.string(),\n  organizationId: z.string(),\n  name: z.string(),\n  membersIds: z.array(z.string()),\n  adminsIds: z.array(z.string()),\n  viewersIds: z.optional(z.array(z.string())),\n  memberAccess: z.optional(z.array(projectMemberGranularAccessSchema)),\n  creatorId: z.string(),\n  configuration: z.optional(projectConfigurationSchema),\n  repository: z.optional(z.nullable(repositoryConnectionSchema)),\n  webhooks: z.optional(projectCISchema),\n  autoFill: z.optional(z.boolean()),\n  /** Screenshot of the application URL, generated automatically. */\n  imageUrl: z.optional(z.string()),\n  environments: z.optional(z.array(environmentSchema)),\n  oAuth2Access: z.array(accessKeySchema),\n  createdAt: dateTimeSchema,\n  updatedAt: dateTimeSchema,\n});\n\n/** Translation health of one locale of a project. */\nexport const localeInsightSchema = z.object({\n  locale: localeSchema,\n  isDefault: z.boolean(),\n  translatedKeys: z.number(),\n  totalKeys: z.number(),\n  missingKeys: z.number(),\n  /** Ratio in the `[0, 1]` range. */\n  completionRate: z.number(),\n});\n\n/** Project-wide localization insights shown on the dashboard overview. */\nexport const projectInsightsSchema = z.object({\n  projectId: z.string(),\n  /** Unix epoch (ms) at which the snapshot was computed. */\n  generatedAt: z.number(),\n  defaultLocale: z.nullable(localeSchema),\n  localeCount: z.number(),\n  dictionaryCount: z.number(),\n  keyCount: z.number(),\n  translationUnitCount: z.number(),\n  translatedUnitCount: z.number(),\n  overallCompletionRate: z.number(),\n  fullyTranslatedLocaleCount: z.number(),\n  dictionariesWithMissingTranslations: z.number(),\n  missingTranslationCount: z.number(),\n  localeInsights: z.array(localeInsightSchema),\n  recentlyUpdated: z.array(\n    z.object({ key: z.string(), updatedAt: z.number() })\n  ),\n  lastUpdatedAt: z.nullable(z.number()),\n  memberCount: z.number(),\n  adminCount: z.number(),\n  environmentCount: z.number(),\n  autoFill: z.boolean(),\n  aiConfigured: z.boolean(),\n  repositoryProvider: z.nullable(repositoryProviderSchema),\n  applicationURL: z.nullable(z.string()),\n});\n\n/** CI configuration file status of the connected repository. */\nexport const ciStatusSchema = z.object({\n  exists: z.boolean(),\n  content: z.string(),\n  path: z.string(),\n  fileUrl: z.optional(z.string()),\n  allowAutoPush: z.boolean(),\n});\n\nconst projectIdParamsSchema = z.object({ projectId: objectIdSchema });\nconst clientIdBodySchema = z.object({ clientId: z.string() });\n\nconst ciTargetResultSchema = z.object({\n  target: z.string(),\n  success: z.boolean(),\n  message: z.optional(z.string()),\n});\n\n/** REST contract of the `/api/project` routes. */\nexport const projectContract = defineRouteGroup({\n  prefix: '/api/project',\n  tag: 'Project',\n  routes: {\n    getProjects: defineRoute({\n      method: 'GET',\n      path: '/',\n      summary: 'List the projects visible to the session',\n      schemas: {\n        querystring: z.looseObject({\n          ...paginationQueryShape,\n          ids: z.optional(repeatableQueryValueSchema),\n          name: z.optional(z.string()),\n          search: z.optional(z.string()),\n          organizationId: z.optional(z.string()),\n          membersIds: z.optional(repeatableQueryValueSchema),\n          sortBy: z.optional(z.string()),\n          sortOrder: z.optional(z.string()),\n          /** Admin only: list projects of every organization. */\n          fetchAll: z.optional(z.enum(['true', 'false'])),\n        }),\n        response: { 200: paginatedResponseSchema(projectSchema) },\n      },\n    }),\n    getProjectInsights: defineRoute({\n      method: 'GET',\n      path: '/insights',\n      summary: 'Localization insights of the selected project',\n      schemas: {\n        response: { 200: responseDataSchema(projectInsightsSchema) },\n      },\n    }),\n    addProject: defineRoute({\n      method: 'POST',\n      path: '/',\n      summary: 'Create a project in the selected organization',\n      schemas: {\n        body: z.looseObject({ name: z.string().check(z.minLength(1)) }),\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    updateProject: defineRoute({\n      method: 'PUT',\n      path: '/',\n      summary: 'Update the selected project',\n      schemas: {\n        /**\n         * Allow-list: membership and ownership fields (`adminsIds`,\n         * `membersIds`, `viewersIds`, `creatorId`, `memberAccess`,\n         * `environments`) are stripped, they only change through their\n         * dedicated endpoints and the invariants those enforce.\n         */\n        body: z.object({\n          name: z.optional(z.string().check(z.minLength(1))),\n          configuration: z.optional(projectConfigurationSchema),\n          autoFill: z.optional(z.boolean()),\n          webhooks: z.optional(projectCISchema),\n          /** `null` disconnects the repository. */\n          repository: z.optional(z.nullable(repositoryConnectionSchema)),\n        }),\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    updateProjectMembers: defineRoute({\n      method: 'PUT',\n      path: '/members',\n      summary: 'Replace the members of the selected project',\n      schemas: {\n        body: z.object({\n          membersIds: z.optional(\n            z.array(\n              z.object({\n                userId: objectIdSchema,\n                isAdmin: z.optional(z.boolean()),\n              })\n            )\n          ),\n        }),\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    pushProjectConfiguration: defineRoute({\n      method: 'PUT',\n      path: '/configuration',\n      summary: 'Push the local Intlayer configuration to the project',\n      schemas: {\n        body: projectConfigurationSchema,\n        response: { 200: responseDataSchema(projectConfigurationSchema) },\n      },\n    }),\n    deleteProject: defineRoute({\n      method: 'DELETE',\n      path: '/',\n      summary: 'Delete the selected project',\n      schemas: {\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    selectProject: defineRoute({\n      method: 'PUT',\n      path: '/:projectId',\n      summary: 'Select a project for the current session',\n      schemas: {\n        params: projectIdParamsSchema,\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    unselectProject: defineRoute({\n      method: 'POST',\n      path: '/logout',\n      summary: 'Unselect the project of the current session',\n      schemas: {\n        response: { 200: responseDataSchema(z.null()) },\n      },\n    }),\n    addNewAccessKey: defineRoute({\n      method: 'POST',\n      path: '/access_key',\n      summary: 'Create an access key for the selected project',\n      schemas: {\n        body: z.object({\n          name: z.string().check(z.minLength(1)),\n          grants: z.array(z.string()),\n          /** ISO date-time, parsed to a `Date`; omitted for a key that never expires. */\n          expiresAt: z.optional(\n            z.pipe(\n              z.iso.datetime(),\n              z.transform((value) => new Date(value))\n            )\n          ),\n          allowedEnvironmentIds: z.optional(allowedEnvironmentIdsSchema),\n          allowedLocales: z.optional(allowedLocalesSchema),\n        }),\n        response: { 200: responseDataSchema(accessKeySchema) },\n      },\n    }),\n    refreshAccessKey: defineRoute({\n      method: 'PATCH',\n      path: '/access_key',\n      summary: 'Regenerate the secret of an access key',\n      schemas: {\n        body: clientIdBodySchema,\n        response: { 200: responseDataSchema(accessKeySchema) },\n      },\n    }),\n    deleteAccessKey: defineRoute({\n      method: 'DELETE',\n      path: '/access_key',\n      summary: 'Delete an access key',\n      schemas: {\n        body: clientIdBodySchema,\n        response: { 200: responseDataSchema(z.null()) },\n      },\n    }),\n    triggerBuild: defineRoute({\n      method: 'POST',\n      path: '/build',\n      summary: 'Trigger the CI pipelines and webhooks of the project',\n      schemas: {\n        response: {\n          200: responseDataSchema(\n            z.object({ results: z.array(ciTargetResultSchema) })\n          ),\n        },\n      },\n    }),\n    triggerWebhook: defineRoute({\n      method: 'POST',\n      path: '/webhook',\n      summary: 'Trigger a single project webhook',\n      schemas: {\n        body: z.object({ webhookIndex: z.int().check(z.gte(0)) }),\n        response: { 200: responseDataSchema(ciTargetResultSchema) },\n      },\n    }),\n    getCIConfiguration: defineRoute({\n      method: 'GET',\n      path: '/ci',\n      summary: 'CI configuration status of the connected repository',\n      schemas: {\n        response: { 200: responseDataSchema(ciStatusSchema) },\n      },\n    }),\n    pushCIConfiguration: defineRoute({\n      method: 'POST',\n      path: '/ci',\n      summary: 'Commit the CI configuration file to the repository',\n      schemas: {\n        response: {\n          200: responseDataSchema(z.object({ success: z.boolean() })),\n        },\n      },\n    }),\n    deleteProjectByIdAdmin: defineRoute({\n      method: 'DELETE',\n      path: '/:projectId/admin',\n      summary: 'Admin only: delete any project',\n      schemas: {\n        params: projectIdParamsSchema,\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    updateMemberAccess: defineRoute({\n      method: 'PUT',\n      path: '/member/:userId/access',\n      summary: 'Restrict the environments and locales of a project member',\n      schemas: {\n        params: z.object({ userId: objectIdSchema }),\n        body: z.object({\n          allowedEnvironmentIds: allowedEnvironmentIdsSchema,\n          allowedLocales: allowedLocalesSchema,\n        }),\n        response: {\n          200: responseDataSchema(projectMemberGranularAccessSchema),\n        },\n      },\n    }),\n  },\n});\n\n/** Route definitions of the `/api/project` group, by name. */\nexport type ProjectRoutes = (typeof projectContract)['routes'];\n\n// Entity types\nexport type ProjectConfiguration = z.output<typeof projectConfigurationSchema>;\nexport type Webhook = z.output<typeof webhookSchema>;\nexport type ProjectConfigCI = z.output<typeof projectCISchema>;\nexport type RepositoryProvider = z.output<typeof repositoryProviderSchema>;\nexport type RepositoryConnection = z.output<typeof repositoryConnectionSchema>;\nexport type EnvironmentAPI = z.output<typeof environmentSchema>;\nexport type ProjectMemberGranularAccessAPI = z.output<\n  typeof projectMemberGranularAccessSchema\n>;\nexport type OAuth2AccessAPI = z.output<typeof accessKeySchema>;\nexport type ProjectAPI = z.output<typeof projectSchema>;\nexport type ProjectInsights = z.output<typeof projectInsightsSchema>;\nexport type CIStatus = z.output<typeof ciStatusSchema>;\n\n// Request / response types\nexport type GetProjectsParams = RouteQuerystring<ProjectRoutes['getProjects']>;\nexport type GetProjectsResult = PaginatedResponse<ProjectAPI>;\nexport type GetProjectInsightsResult = ResponseData<ProjectInsights>;\nexport type AddProjectBody = RouteBodyInput<ProjectRoutes['addProject']>;\nexport type AddProjectResult = ResponseData<ProjectAPI>;\nexport type UpdateProjectBody = RouteBodyInput<ProjectRoutes['updateProject']>;\nexport type UpdateProjectResult = ResponseData<ProjectAPI>;\nexport type UpdateProjectMembersBody = RouteBodyInput<\n  ProjectRoutes['updateProjectMembers']\n>;\nexport type UpdateProjectMembersResult = ResponseData<ProjectAPI>;\nexport type PushProjectConfigurationBody = RouteBodyInput<\n  ProjectRoutes['pushProjectConfiguration']\n>;\nexport type PushProjectConfigurationResult = ResponseData<ProjectConfiguration>;\nexport type DeleteProjectResult = ResponseData<ProjectAPI>;\nexport type SelectProjectParam = RouteParams<ProjectRoutes['selectProject']>;\nexport type SelectProjectResult = ResponseData<ProjectAPI>;\nexport type UnselectProjectResult = ResponseData<null>;\n/** `expiresAt` also accepts a `Date`: JSON serializes it to an ISO string. */\nexport type AddNewAccessKeyBody = Omit<\n  RouteBodyInput<ProjectRoutes['addNewAccessKey']>,\n  'expiresAt'\n> & { expiresAt?: Date | string };\nexport type AddNewAccessKeyResponse = ResponseData<OAuth2AccessAPI>;\nexport type RefreshAccessKeyBody = RouteBody<ProjectRoutes['refreshAccessKey']>;\nexport type RefreshAccessKeyResponse = ResponseData<OAuth2AccessAPI>;\nexport type DeleteAccessKeyBody = RouteBody<ProjectRoutes['deleteAccessKey']>;\nexport type DeleteAccessKeyResponse = ResponseData<null>;\nexport type TriggerBuildResult = ResponseData<{\n  results: z.output<typeof ciTargetResultSchema>[];\n}>;\nexport type TriggerWebhookBody = RouteBody<ProjectRoutes['triggerWebhook']>;\nexport type TriggerWebhookResult = ResponseData<\n  z.output<typeof ciTargetResultSchema>\n>;\nexport type GetCIConfigurationResult = ResponseData<CIStatus>;\nexport type PushCIConfigurationResult = ResponseData<{ success: boolean }>;\nexport type DeleteProjectByIdAdminResult = ResponseData<ProjectAPI>;\nexport type UpdateMemberAccessParams = RouteParams<\n  ProjectRoutes['updateMemberAccess']\n>;\nexport type UpdateMemberAccessBody = RouteBodyInput<\n  ProjectRoutes['updateMemberAccess']\n>;\nexport type UpdateMemberAccessResult =\n  ResponseData<ProjectMemberGranularAccessAPI>;\n"],"mappings":"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"}
+{"version":3,"file":"project.cjs","names":["typedStringSchema","z","typedValueSchema","dateTimeSchema","objectIdSchema","defineRouteGroup","defineRoute","paginationQueryShape","repeatableQueryValueSchema","paginatedResponseSchema","responseDataSchema"],"sources":["../../src/project.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { AiConfig, URLType } from '@intlayer/types/config';\nimport { z } from 'zod/mini';\nimport {\n  dateTimeSchema,\n  objectIdSchema,\n  paginationQueryShape,\n  repeatableQueryValueSchema,\n  typedStringSchema,\n  typedValueSchema,\n} from './common';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBody,\n  type RouteBodyInput,\n  type RouteParams,\n  type RouteQuerystring,\n} from './defineRoute';\nimport {\n  type PaginatedResponse,\n  paginatedResponseSchema,\n  type ResponseData,\n  responseDataSchema,\n} from './responseData';\n\n/** Locale code (ex: `en`, `fr-CA`). */\nexport const localeSchema = typedStringSchema<Locale>();\n\n/** Project AI settings: the Intlayer AI config plus the masked key state. */\nexport type ProjectConfigAI = Partial<AiConfig> & {\n  /** Masked API key (`sk-proj-****abcd`), never the real one. */\n  apiKey?: string;\n  apiKeyConfigured?: boolean;\n  /**\n   * `false` runs AI calls on the plan credits instead of the own key.\n   * Missing means enabled.\n   */\n  isOwnAPIKeyEnabled?: boolean;\n};\n\n/**\n * Project-level overrides of the Intlayer configuration. Loose objects: the\n * CLI pushes whole config sections, unknown keys must reach the service.\n */\nexport const projectConfigurationSchema = z.looseObject({\n  internationalization: z.optional(\n    z.looseObject({\n      locales: z.optional(z.array(localeSchema)),\n      defaultLocale: z.optional(localeSchema),\n    })\n  ),\n  editor: z.optional(\n    z.looseObject({\n      applicationURL: z.optional(typedStringSchema<URLType>()),\n      cmsURL: z.optional(typedStringSchema<URLType>()),\n    })\n  ),\n  ai: z.optional(typedValueSchema<ProjectConfigAI>()),\n});\n\n/** Generic build webhook (Vercel, Netlify, custom). */\nexport const webhookSchema = z.looseObject({\n  id: z.optional(z.string()),\n  name: z.string(),\n  url: z.string(),\n  enabled: z.optional(z.boolean()),\n  /** Optional signature secret. */\n  secret: z.optional(z.string()),\n});\n\n/** Build triggers: git provider pipeline + generic webhooks. */\nexport const projectCISchema = z.object({\n  autoTriggerBuilds: z.optional(z.boolean()),\n  /** Commit CMS edits of `hybrid` dictionaries back to their source file. */\n  autoCommitDictionaries: z.optional(z.boolean()),\n  webhooks: z.optional(z.array(webhookSchema)),\n});\n\n/** Git provider of a connected repository. */\nexport const repositoryProviderSchema = z.enum([\n  'github',\n  'gitlab',\n  'bitbucket',\n  'codeberg',\n  'gitee',\n]);\n\nconst baseRepositoryShape = {\n  owner: z.string(),\n  repository: z.string(),\n  branch: z.string(),\n  url: z.string(),\n  configFilePath: z.string(),\n};\n\n/**\n * Git repository connected to a project. The repo-scoped token never leaves\n * the server.\n */\nexport const repositoryConnectionSchema = z.discriminatedUnion('provider', [\n  z.looseObject({\n    provider: z.literal('github'),\n    ...baseRepositoryShape,\n    installationId: z.optional(z.number()),\n  }),\n  z.looseObject({\n    provider: z.literal('gitlab'),\n    ...baseRepositoryShape,\n    projectId: z.optional(z.number()),\n    /** Custom GitLab instance URL (ex: https://gitlab.company.com). */\n    instanceUrl: z.optional(z.string()),\n  }),\n  z.looseObject({\n    provider: z.literal('bitbucket'),\n    ...baseRepositoryShape,\n    workspace: z.string(),\n  }),\n  z.looseObject({ provider: z.literal('codeberg'), ...baseRepositoryShape }),\n  z.looseObject({ provider: z.literal('gitee'), ...baseRepositoryShape }),\n]);\n\n/** null = unrestricted, [] = no access, array = allowed ids (null = production). */\nconst allowedEnvironmentIdsSchema = z.nullable(z.array(z.nullable(z.string())));\n/** null = unrestricted, [] = no access, array = allowed locales. */\nconst allowedLocalesSchema = z.nullable(z.array(localeSchema));\n\n/** Project environment (production is injected when none is the default). */\nexport const environmentSchema = z.looseObject({\n  id: z.string(),\n  name: z.string(),\n  isDefault: z.boolean(),\n  configuration: z.optional(projectConfigurationSchema),\n  createdAt: z.optional(dateTimeSchema),\n  updatedAt: z.optional(dateTimeSchema),\n});\n\n/** Granular per-member access, overlaid on the member's role. */\nexport const projectMemberGranularAccessSchema = z.object({\n  userId: z.string(),\n  allowedEnvironmentIds: allowedEnvironmentIdsSchema,\n  allowedLocales: allowedLocalesSchema,\n});\n\n/** Access key (OAuth2 client credentials). Live bearer tokens are never sent. */\nexport const accessKeySchema = z.looseObject({\n  id: z.string(),\n  name: z.string(),\n  clientId: z.string(),\n  /** Shown to project members (dashboard copy, CLI login). */\n  clientSecret: z.string(),\n  grants: z.array(z.string()),\n  userId: z.string(),\n  expiresAt: z.optional(z.nullable(dateTimeSchema)),\n  allowedEnvironmentIds: z.optional(allowedEnvironmentIdsSchema),\n  allowedLocales: z.optional(allowedLocalesSchema),\n  createdAt: dateTimeSchema,\n  updatedAt: dateTimeSchema,\n});\n\n/** Project as returned by the API. */\nexport const projectSchema = z.looseObject({\n  id: z.string(),\n  organizationId: z.string(),\n  name: z.string(),\n  membersIds: z.array(z.string()),\n  adminsIds: z.array(z.string()),\n  viewersIds: z.optional(z.array(z.string())),\n  memberAccess: z.optional(z.array(projectMemberGranularAccessSchema)),\n  creatorId: z.string(),\n  configuration: z.optional(projectConfigurationSchema),\n  repository: z.optional(z.nullable(repositoryConnectionSchema)),\n  webhooks: z.optional(projectCISchema),\n  autoFill: z.optional(z.boolean()),\n  /** Screenshot of the application URL, generated automatically. */\n  imageUrl: z.optional(z.string()),\n  environments: z.optional(z.array(environmentSchema)),\n  oAuth2Access: z.array(accessKeySchema),\n  createdAt: dateTimeSchema,\n  updatedAt: dateTimeSchema,\n});\n\n/** Translation health of one locale of a project. */\nexport const localeInsightSchema = z.object({\n  locale: localeSchema,\n  isDefault: z.boolean(),\n  translatedKeys: z.number(),\n  totalKeys: z.number(),\n  missingKeys: z.number(),\n  /** Ratio in the `[0, 1]` range. */\n  completionRate: z.number(),\n});\n\n/** Project-wide localization insights shown on the dashboard overview. */\nexport const projectInsightsSchema = z.object({\n  projectId: z.string(),\n  /** Unix epoch (ms) at which the snapshot was computed. */\n  generatedAt: z.number(),\n  defaultLocale: z.nullable(localeSchema),\n  localeCount: z.number(),\n  dictionaryCount: z.number(),\n  keyCount: z.number(),\n  translationUnitCount: z.number(),\n  translatedUnitCount: z.number(),\n  overallCompletionRate: z.number(),\n  fullyTranslatedLocaleCount: z.number(),\n  dictionariesWithMissingTranslations: z.number(),\n  missingTranslationCount: z.number(),\n  localeInsights: z.array(localeInsightSchema),\n  recentlyUpdated: z.array(\n    z.object({ key: z.string(), updatedAt: z.number() })\n  ),\n  lastUpdatedAt: z.nullable(z.number()),\n  memberCount: z.number(),\n  adminCount: z.number(),\n  environmentCount: z.number(),\n  autoFill: z.boolean(),\n  aiConfigured: z.boolean(),\n  repositoryProvider: z.nullable(repositoryProviderSchema),\n  applicationURL: z.nullable(z.string()),\n});\n\n/** CI configuration file status of the connected repository. */\nexport const ciStatusSchema = z.object({\n  exists: z.boolean(),\n  content: z.string(),\n  path: z.string(),\n  fileUrl: z.optional(z.string()),\n  allowAutoPush: z.boolean(),\n});\n\nconst projectIdParamsSchema = z.object({ projectId: objectIdSchema });\nconst clientIdBodySchema = z.object({ clientId: z.string() });\n\nconst ciTargetResultSchema = z.object({\n  target: z.string(),\n  success: z.boolean(),\n  message: z.optional(z.string()),\n});\n\n/** REST contract of the `/api/project` routes. */\nexport const projectContract = defineRouteGroup({\n  prefix: '/api/project',\n  tag: 'Project',\n  routes: {\n    getProjects: defineRoute({\n      method: 'GET',\n      path: '/',\n      summary: 'List the projects visible to the session',\n      schemas: {\n        querystring: z.looseObject({\n          ...paginationQueryShape,\n          ids: z.optional(repeatableQueryValueSchema),\n          name: z.optional(z.string()),\n          search: z.optional(z.string()),\n          organizationId: z.optional(z.string()),\n          membersIds: z.optional(repeatableQueryValueSchema),\n          sortBy: z.optional(z.string()),\n          sortOrder: z.optional(z.string()),\n          /** Admin only: list projects of every organization. */\n          fetchAll: z.optional(z.enum(['true', 'false'])),\n        }),\n        response: { 200: paginatedResponseSchema(projectSchema) },\n      },\n    }),\n    getProjectInsights: defineRoute({\n      method: 'GET',\n      path: '/insights',\n      summary: 'Localization insights of the selected project',\n      schemas: {\n        response: { 200: responseDataSchema(projectInsightsSchema) },\n      },\n    }),\n    addProject: defineRoute({\n      method: 'POST',\n      path: '/',\n      summary: 'Create a project in the selected organization',\n      schemas: {\n        body: z.looseObject({ name: z.string().check(z.minLength(1)) }),\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    updateProject: defineRoute({\n      method: 'PUT',\n      path: '/',\n      summary: 'Update the selected project',\n      schemas: {\n        /**\n         * Allow-list: membership and ownership fields (`adminsIds`,\n         * `membersIds`, `viewersIds`, `creatorId`, `memberAccess`,\n         * `environments`) are stripped, they only change through their\n         * dedicated endpoints and the invariants those enforce.\n         */\n        body: z.object({\n          name: z.optional(z.string().check(z.minLength(1))),\n          configuration: z.optional(projectConfigurationSchema),\n          autoFill: z.optional(z.boolean()),\n          webhooks: z.optional(projectCISchema),\n          /** `null` disconnects the repository. */\n          repository: z.optional(z.nullable(repositoryConnectionSchema)),\n        }),\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    updateProjectMembers: defineRoute({\n      method: 'PUT',\n      path: '/members',\n      summary: 'Replace the members of the selected project',\n      schemas: {\n        body: z.object({\n          membersIds: z.optional(\n            z.array(\n              z.object({\n                userId: objectIdSchema,\n                isAdmin: z.optional(z.boolean()),\n              })\n            )\n          ),\n        }),\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    pushProjectConfiguration: defineRoute({\n      method: 'PUT',\n      path: '/configuration',\n      summary: 'Push the local Intlayer configuration to the project',\n      schemas: {\n        body: projectConfigurationSchema,\n        response: { 200: responseDataSchema(projectConfigurationSchema) },\n      },\n    }),\n    deleteProject: defineRoute({\n      method: 'DELETE',\n      path: '/',\n      summary: 'Delete the selected project',\n      schemas: {\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    selectProject: defineRoute({\n      method: 'PUT',\n      path: '/:projectId',\n      summary: 'Select a project for the current session',\n      schemas: {\n        params: projectIdParamsSchema,\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    unselectProject: defineRoute({\n      method: 'POST',\n      path: '/logout',\n      summary: 'Unselect the project of the current session',\n      schemas: {\n        response: { 200: responseDataSchema(z.null()) },\n      },\n    }),\n    addNewAccessKey: defineRoute({\n      method: 'POST',\n      path: '/access_key',\n      summary: 'Create an access key for the selected project',\n      schemas: {\n        body: z.object({\n          name: z.string().check(z.minLength(1)),\n          grants: z.array(z.string()),\n          /** ISO date-time, parsed to a `Date`; omitted for a key that never expires. */\n          expiresAt: z.optional(\n            z.pipe(\n              z.iso.datetime(),\n              z.transform((value) => new Date(value))\n            )\n          ),\n          allowedEnvironmentIds: z.optional(allowedEnvironmentIdsSchema),\n          allowedLocales: z.optional(allowedLocalesSchema),\n        }),\n        response: { 200: responseDataSchema(accessKeySchema) },\n      },\n    }),\n    refreshAccessKey: defineRoute({\n      method: 'PATCH',\n      path: '/access_key',\n      summary: 'Regenerate the secret of an access key',\n      schemas: {\n        body: clientIdBodySchema,\n        response: { 200: responseDataSchema(accessKeySchema) },\n      },\n    }),\n    deleteAccessKey: defineRoute({\n      method: 'DELETE',\n      path: '/access_key',\n      summary: 'Delete an access key',\n      schemas: {\n        body: clientIdBodySchema,\n        response: { 200: responseDataSchema(z.null()) },\n      },\n    }),\n    triggerBuild: defineRoute({\n      method: 'POST',\n      path: '/build',\n      summary: 'Trigger the CI pipelines and webhooks of the project',\n      schemas: {\n        response: {\n          200: responseDataSchema(\n            z.object({ results: z.array(ciTargetResultSchema) })\n          ),\n        },\n      },\n    }),\n    triggerWebhook: defineRoute({\n      method: 'POST',\n      path: '/webhook',\n      summary: 'Trigger a single project webhook',\n      schemas: {\n        body: z.object({ webhookIndex: z.int().check(z.gte(0)) }),\n        response: { 200: responseDataSchema(ciTargetResultSchema) },\n      },\n    }),\n    getCIConfiguration: defineRoute({\n      method: 'GET',\n      path: '/ci',\n      summary: 'CI configuration status of the connected repository',\n      schemas: {\n        response: { 200: responseDataSchema(ciStatusSchema) },\n      },\n    }),\n    pushCIConfiguration: defineRoute({\n      method: 'POST',\n      path: '/ci',\n      summary: 'Commit the CI configuration file to the repository',\n      schemas: {\n        response: {\n          200: responseDataSchema(z.object({ success: z.boolean() })),\n        },\n      },\n    }),\n    deleteProjectByIdAdmin: defineRoute({\n      method: 'DELETE',\n      path: '/:projectId/admin',\n      summary: 'Admin only: delete any project',\n      schemas: {\n        params: projectIdParamsSchema,\n        response: { 200: responseDataSchema(projectSchema) },\n      },\n    }),\n    updateMemberAccess: defineRoute({\n      method: 'PUT',\n      path: '/member/:userId/access',\n      summary: 'Restrict the environments and locales of a project member',\n      schemas: {\n        params: z.object({ userId: objectIdSchema }),\n        body: z.object({\n          allowedEnvironmentIds: allowedEnvironmentIdsSchema,\n          allowedLocales: allowedLocalesSchema,\n        }),\n        response: {\n          200: responseDataSchema(projectMemberGranularAccessSchema),\n        },\n      },\n    }),\n  },\n});\n\n/** Route definitions of the `/api/project` group, by name. */\nexport type ProjectRoutes = (typeof projectContract)['routes'];\n\n// Entity types\nexport type ProjectConfiguration = z.output<typeof projectConfigurationSchema>;\nexport type Webhook = z.output<typeof webhookSchema>;\nexport type ProjectConfigCI = z.output<typeof projectCISchema>;\nexport type RepositoryProvider = z.output<typeof repositoryProviderSchema>;\nexport type RepositoryConnection = z.output<typeof repositoryConnectionSchema>;\nexport type EnvironmentAPI = z.output<typeof environmentSchema>;\nexport type ProjectMemberGranularAccessAPI = z.output<\n  typeof projectMemberGranularAccessSchema\n>;\nexport type OAuth2AccessAPI = z.output<typeof accessKeySchema>;\nexport type ProjectAPI = z.output<typeof projectSchema>;\nexport type ProjectInsights = z.output<typeof projectInsightsSchema>;\nexport type CIStatus = z.output<typeof ciStatusSchema>;\n\n// Request / response types\nexport type GetProjectsParams = RouteQuerystring<ProjectRoutes['getProjects']>;\nexport type GetProjectsResult = PaginatedResponse<ProjectAPI>;\nexport type GetProjectInsightsResult = ResponseData<ProjectInsights>;\nexport type AddProjectBody = RouteBodyInput<ProjectRoutes['addProject']>;\nexport type AddProjectResult = ResponseData<ProjectAPI>;\nexport type UpdateProjectBody = RouteBodyInput<ProjectRoutes['updateProject']>;\nexport type UpdateProjectResult = ResponseData<ProjectAPI>;\nexport type UpdateProjectMembersBody = RouteBodyInput<\n  ProjectRoutes['updateProjectMembers']\n>;\nexport type UpdateProjectMembersResult = ResponseData<ProjectAPI>;\nexport type PushProjectConfigurationBody = RouteBodyInput<\n  ProjectRoutes['pushProjectConfiguration']\n>;\nexport type PushProjectConfigurationResult = ResponseData<ProjectConfiguration>;\nexport type DeleteProjectResult = ResponseData<ProjectAPI>;\nexport type SelectProjectParam = RouteParams<ProjectRoutes['selectProject']>;\nexport type SelectProjectResult = ResponseData<ProjectAPI>;\nexport type UnselectProjectResult = ResponseData<null>;\n/** `expiresAt` also accepts a `Date`: JSON serializes it to an ISO string. */\nexport type AddNewAccessKeyBody = Omit<\n  RouteBodyInput<ProjectRoutes['addNewAccessKey']>,\n  'expiresAt'\n> & { expiresAt?: Date | string };\nexport type AddNewAccessKeyResponse = ResponseData<OAuth2AccessAPI>;\nexport type RefreshAccessKeyBody = RouteBody<ProjectRoutes['refreshAccessKey']>;\nexport type RefreshAccessKeyResponse = ResponseData<OAuth2AccessAPI>;\nexport type DeleteAccessKeyBody = RouteBody<ProjectRoutes['deleteAccessKey']>;\nexport type DeleteAccessKeyResponse = ResponseData<null>;\nexport type TriggerBuildResult = ResponseData<{\n  results: z.output<typeof ciTargetResultSchema>[];\n}>;\nexport type TriggerWebhookBody = RouteBody<ProjectRoutes['triggerWebhook']>;\nexport type TriggerWebhookResult = ResponseData<\n  z.output<typeof ciTargetResultSchema>\n>;\nexport type GetCIConfigurationResult = ResponseData<CIStatus>;\nexport type PushCIConfigurationResult = ResponseData<{ success: boolean }>;\nexport type DeleteProjectByIdAdminResult = ResponseData<ProjectAPI>;\nexport type UpdateMemberAccessParams = RouteParams<\n  ProjectRoutes['updateMemberAccess']\n>;\nexport type UpdateMemberAccessBody = RouteBodyInput<\n  ProjectRoutes['updateMemberAccess']\n>;\nexport type UpdateMemberAccessResult =\n  ResponseData<ProjectMemberGranularAccessAPI>;\n"],"mappings":"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"}

package/dist/esm/analytics.mjs

@@ -1,3 +1,4 @@
+import { ANALYTICS_ACTIVE_USERS_RETENTION_DAYS, ANALYTICS_ANNOTATION_TYPES, ANALYTICS_DIMENSION_DESCRIPTIONS, ANALYTICS_METRIC_DESCRIPTIONS, ANALYTICS_METRIC_DIMENSIONS, ANALYTICS_REALTIME_DIMENSIONS, ANALYTICS_REALTIME_MAX_MINUTES, ANALYTICS_REALTIME_METRICS, ANALYTICS_REPORT_DEFAULT_LIMIT, ANALYTICS_REPORT_DIMENSIONS, ANALYTICS_REPORT_MAX_DATE_RANGES, ANALYTICS_REPORT_MAX_LIMIT, ANALYTICS_REPORT_METRICS, ANALYTICS_TIME_DIMENSIONS, analyticsAnnotationSchema, analyticsAnnotationsQuerySchema, analyticsDateRangeSchema, analyticsDimensionFilterSchema, analyticsMetricFilterSchema, analyticsOrderBySchema, analyticsRealtimeReportRequestSchema, analyticsReportRequestSchema, analyticsReportRowSchema, analyticsReportSchema, analyticsSchemaInfoSchema } from "./analyticsReport.mjs";
 import { defineRoute, defineRouteGroup } from "./defineRoute.mjs";
 import { responseDataSchema } from "./responseData.mjs";
 import { z } from "zod/mini";
@@ -255,6 +256,39 @@ const analyticsContract = defineRouteGroup({
 				response: { 200: responseDataSchema(experimentResultSchema) }
 			}
 		}),
+		getAnalyticsSchema: defineRoute({
+			method: "GET",
+			path: "/schema",
+			summary: "Report dimensions, metrics, their compatibility, retention and experiments",
+			schemas: { response: { 200: responseDataSchema(analyticsSchemaInfoSchema) } }
+		}),
+		runAnalyticsReport: defineRoute({
+			method: "POST",
+			path: "/report",
+			summary: "Aggregated report: metrics broken down by dimensions over date ranges",
+			schemas: {
+				body: analyticsReportRequestSchema,
+				response: { 200: responseDataSchema(analyticsReportSchema) }
+			}
+		}),
+		runAnalyticsRealtimeReport: defineRoute({
+			method: "POST",
+			path: "/realtime-report",
+			summary: "Aggregated activity of the last minutes (up to one hour)",
+			schemas: {
+				body: analyticsRealtimeReportRequestSchema,
+				response: { 200: responseDataSchema(analyticsReportSchema) }
+			}
+		}),
+		getAnalyticsAnnotations: defineRoute({
+			method: "GET",
+			path: "/annotations",
+			summary: "Dated content and traffic events (dictionary edits, repo syncs, new locales, experiments)",
+			schemas: {
+				querystring: analyticsAnnotationsQuerySchema,
+				response: { 200: responseDataSchema(z.array(analyticsAnnotationSchema)) }
+			}
+		}),
 		getPageMetadata: defineRoute({
 			method: "GET",
 			path: "/page-metadata",
@@ -267,5 +301,5 @@ const analyticsContract = defineRouteGroup({
 	}
 });
 
-export { PAGE_FLOW_ENTRANCE, analyticsContract, analyticsEventTypeSchema, audienceGranularitySchema, audienceRangeSchema, audienceSeriesPointSchema, audienceStatsSchema, incomingAnalyticsEventSchema, liveVisitorFlowSchema, liveVisitorFlowStepSchema, liveVisitorSchema, pageFlowLinkSchema, pageFlowNodeSchema, pageFlowSchema };
+export { ANALYTICS_ACTIVE_USERS_RETENTION_DAYS, ANALYTICS_ANNOTATION_TYPES, ANALYTICS_DIMENSION_DESCRIPTIONS, ANALYTICS_METRIC_DESCRIPTIONS, ANALYTICS_METRIC_DIMENSIONS, ANALYTICS_REALTIME_DIMENSIONS, ANALYTICS_REALTIME_MAX_MINUTES, ANALYTICS_REALTIME_METRICS, ANALYTICS_REPORT_DEFAULT_LIMIT, ANALYTICS_REPORT_DIMENSIONS, ANALYTICS_REPORT_MAX_DATE_RANGES, ANALYTICS_REPORT_MAX_LIMIT, ANALYTICS_REPORT_METRICS, ANALYTICS_TIME_DIMENSIONS, PAGE_FLOW_ENTRANCE, analyticsAnnotationSchema, analyticsAnnotationsQuerySchema, analyticsContract, analyticsDateRangeSchema, analyticsDimensionFilterSchema, analyticsEventTypeSchema, analyticsMetricFilterSchema, analyticsOrderBySchema, analyticsRealtimeReportRequestSchema, analyticsReportRequestSchema, analyticsReportRowSchema, analyticsReportSchema, analyticsSchemaInfoSchema, audienceGranularitySchema, audienceRangeSchema, audienceSeriesPointSchema, audienceStatsSchema, incomingAnalyticsEventSchema, liveVisitorFlowSchema, liveVisitorFlowStepSchema, liveVisitorSchema, pageFlowLinkSchema, pageFlowNodeSchema, pageFlowSchema };
 //# sourceMappingURL=analytics.mjs.map

package/dist/esm/analytics.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.mjs","names":[],"sources":["../../src/analytics.ts"],"sourcesContent":["import { z } from 'zod/mini';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBodyInput,\n} from './defineRoute';\nimport { type ResponseData, responseDataSchema } from './responseData';\n\n/** Kind of analytics event sent by the SDK. */\nexport const analyticsEventTypeSchema = z.enum([\n  'page_view',\n  'content_exposure',\n  'conversion',\n]);\n\n/** One event as sent by the SDK (batched). */\nexport const incomingAnalyticsEventSchema = z.looseObject({\n  type: analyticsEventTypeSchema,\n  /** Client timestamp (epoch ms). */\n  t: z.number(),\n  locale: z.string(),\n  url: z.string(),\n  ref: z.optional(z.string()),\n  dictionaryKey: z.optional(z.string()),\n  keyPath: z.optional(z.string()),\n  nodeType: z.optional(z.string()),\n  variant: z.optional(z.string()),\n  count: z.optional(z.number()),\n  experimentKey: z.optional(z.string()),\n  goal: z.optional(z.string()),\n  value: z.optional(z.number()),\n});\n\n/**\n * Time windows of the audience report. `live` covers the sessions active in the\n * last 30 minutes, bucketed per minute.\n */\nexport const audienceRangeSchema = z.enum([\n  'live',\n  '1h',\n  '24h',\n  '7d',\n  '30d',\n  '90d',\n  '6mo',\n  '1y',\n  '3y',\n]);\n\nexport const audienceGranularitySchema = z.enum([\n  'minute',\n  'hour',\n  'day',\n  'week',\n  'month',\n]);\n\nexport const audienceSeriesPointSchema = z.object({\n  /** ISO bucket start. */\n  bucket: z.string(),\n  users: z.number(),\n  views: z.number(),\n});\n\nconst audienceBreakdownRowSchema = z.object({\n  key: z.string(),\n  users: z.number(),\n  views: z.number(),\n});\n\n/** A session active in the `live` window, placed on the map. */\nexport const liveVisitorSchema = z.object({\n  /** Opaque, non-reversible visitor id (prefix of the hashed session). */\n  visitorId: z.string(),\n  /** ISO country code, `ZZ` when unknown. */\n  country: z.string(),\n  /** City reported by the CDN, when available. */\n  city: z.optional(z.string()),\n  /** City-level latitude (rounded to ~1 km), when available. */\n  latitude: z.optional(z.number()),\n  /** City-level longitude (rounded to ~1 km), when available. */\n  longitude: z.optional(z.number()),\n  /** Locale the visitor is browsing in. */\n  locale: z.optional(z.string()),\n  /** Page of the visitor's latest activity. */\n  currentUrl: z.string(),\n  /** Pages the visitor was active on during the window. */\n  pageCount: z.number(),\n  /** Page views during the window. */\n  views: z.number(),\n  /** ISO date of the visitor's first activity in the window. */\n  firstSeenAt: z.string(),\n  /** ISO date of the visitor's latest activity. */\n  lastSeenAt: z.string(),\n  /** Minutes (`YYYY-MM-DDTHH:mm`, UTC) the visitor was active in, oldest first. */\n  activeMinutes: z.array(z.string()),\n});\n\n/** One step of a live visitor's journey, oldest first. */\nexport const liveVisitorFlowStepSchema = z.object({\n  url: z.string(),\n  locale: z.optional(z.string()),\n  /** ISO date the visitor reached the page. */\n  firstSeenAt: z.string(),\n  /** ISO date of the visitor's latest activity on the page. */\n  lastSeenAt: z.string(),\n  views: z.number(),\n});\n\n/**\n * Page journey of one live visitor over the `live` window. `visitor` is `null`\n * once the session has left the window (not an error: it simply went quiet).\n */\nexport const liveVisitorFlowSchema = z.object({\n  visitor: z.nullable(liveVisitorSchema),\n  steps: z.array(liveVisitorFlowStepSchema),\n});\n\n/**\n * Pseudo-page a session starts from. Used as the flow's starting page, the\n * next step lists the landing pages.\n */\nexport const PAGE_FLOW_ENTRANCE = '(entrance)';\n\n/** One page of a flow step; `url` is `null` for the \"other pages\" bucket. */\nexport const pageFlowNodeSchema = z.object({\n  url: z.nullable(z.string()),\n  /** Average navigations reaching this page at this step. */\n  value: z.number(),\n  /** Part of `value` that left the site from this page (`null` if unknown). */\n  exits: z.nullable(z.number()),\n});\n\n/** Average navigations from a page of one step to a page of the next. */\nexport const pageFlowLinkSchema = z.object({\n  /** Step of the source page; the target is on `fromStep + 1`. */\n  fromStep: z.number(),\n  fromUrl: z.nullable(z.string()),\n  toUrl: z.nullable(z.string()),\n  value: z.number(),\n});\n\n/** Averaged navigation flow starting from one page. */\nexport const pageFlowSchema = z.object({\n  startUrl: z.string(),\n  range: audienceRangeSchema,\n  /** Pages per step, the starting page alone on step 0. */\n  steps: z.array(z.array(pageFlowNodeSchema)),\n  links: z.array(pageFlowLinkSchema),\n});\n\nexport const audienceStatsSchema = z.object({\n  usersToday: z.number(),\n  usersLast7Days: z.number(),\n  usersInRange: z.number(),\n  viewsInRange: z.number(),\n  range: audienceRangeSchema,\n  rangeHours: z.number(),\n  granularity: audienceGranularitySchema,\n  series: z.array(audienceSeriesPointSchema),\n  byLocale: z.array(audienceBreakdownRowSchema),\n  byCountry: z.array(audienceBreakdownRowSchema),\n  byPage: z.array(audienceBreakdownRowSchema),\n  /** Active sessions with their location — `live` range only. */\n  liveVisitors: z.optional(z.array(liveVisitorSchema)),\n  /** First UTC day with collected data (`YYYY-MM-DD`), `null` before any. */\n  dataSince: z.nullable(z.string()),\n});\n\nconst analyticsOverviewRowSchema = z.object({\n  url: z.string(),\n  locale: z.string(),\n  views: z.number(),\n});\n\nconst contentStatRowSchema = z.object({\n  dictionaryKey: z.string(),\n  keyPath: z.string(),\n  locale: z.string(),\n  exposures: z.number(),\n});\n\nconst experimentResultSchema = z.object({\n  experimentKey: z.string(),\n  variants: z.array(\n    z.object({\n      variant: z.string(),\n      exposures: z.number(),\n      conversions: z.number(),\n      conversionRate: z.number(),\n    })\n  ),\n  pValue: z.nullable(z.number()),\n  winner: z.nullable(z.string()),\n});\n\nconst pageMetadataSchema = z.object({\n  title: z.optional(z.string()),\n  description: z.optional(z.string()),\n});\n\n/** REST contract of the `/api/analytics` routes. */\nexport const analyticsContract = defineRouteGroup({\n  prefix: '/api/analytics',\n  tag: 'Analytics',\n  routes: {\n    ingestAnalyticsEvents: defineRoute({\n      method: 'POST',\n      path: '/events',\n      summary: 'Ingest SDK events (public browser token, rate limited)',\n      schemas: {\n        /** Sent as `text/plain` JSON by `navigator.sendBeacon`. */\n        body: z.looseObject({\n          /** Token from `POST /api/public/token` (`analytics:ingest`). */\n          token: z.optional(z.string()),\n          /** @deprecated Superseded by `token`; still accepted. */\n          clientId: z.optional(z.string()),\n          sessionId: z.string(),\n          sdkVersion: z.string(),\n          events: z.array(incomingAnalyticsEventSchema),\n        }),\n        response: {\n          200: responseDataSchema(z.object({ accepted: z.number() })),\n        },\n      },\n    }),\n    getAnalyticsOverview: defineRoute({\n      method: 'GET',\n      path: '/overview',\n      summary: 'Page views per page and locale',\n      schemas: {\n        response: {\n          200: responseDataSchema(z.array(analyticsOverviewRowSchema)),\n        },\n      },\n    }),\n    getAnalyticsAudience: defineRoute({\n      method: 'GET',\n      path: '/audience',\n      summary: 'Audience report over a time window',\n      schemas: {\n        querystring: z.object({\n          range: z.optional(z.string()),\n          /** Legacy: converted to the closest range. */\n          days: z.optional(z.string()),\n        }),\n        response: { 200: responseDataSchema(audienceStatsSchema) },\n      },\n    }),\n    getLiveVisitorFlow: defineRoute({\n      method: 'GET',\n      path: '/audience/live/visitors/:visitorId',\n      summary: 'Page journey of a visitor active in the last 30 minutes',\n      schemas: {\n        params: z.object({\n          visitorId: z.string().check(z.regex(/^[a-f0-9]{16}$/)),\n        }),\n        response: { 200: responseDataSchema(liveVisitorFlowSchema) },\n      },\n    }),\n    getPageFlow: defineRoute({\n      method: 'GET',\n      path: '/page-flow',\n      summary: 'Average page-to-page navigation flow from a starting page',\n      schemas: {\n        querystring: z.object({\n          range: z.optional(z.string()),\n          /** Starting page pathname; defaults to `/`. */\n          startUrl: z.optional(z.string()),\n        }),\n        response: { 200: responseDataSchema(pageFlowSchema) },\n      },\n    }),\n    getContentStats: defineRoute({\n      method: 'GET',\n      path: '/content-stats',\n      summary: 'Content exposures per dictionary key path and locale',\n      schemas: {\n        response: { 200: responseDataSchema(z.array(contentStatRowSchema)) },\n      },\n    }),\n    getExperimentResults: defineRoute({\n      method: 'GET',\n      path: '/experiments/:experimentKey',\n      summary: 'A/B test results of an experiment',\n      schemas: {\n        params: z.object({ experimentKey: z.string().check(z.minLength(1)) }),\n        response: { 200: responseDataSchema(experimentResultSchema) },\n      },\n    }),\n    getPageMetadata: defineRoute({\n      method: 'GET',\n      path: '/page-metadata',\n      summary: 'Title and description of a page of the project',\n      schemas: {\n        querystring: z.object({ url: z.optional(z.string()) }),\n        response: { 200: responseDataSchema(pageMetadataSchema) },\n      },\n    }),\n  },\n});\n\n/** Route definitions of the `/api/analytics` group, by name. */\nexport type AnalyticsRoutes = (typeof analyticsContract)['routes'];\n\nexport type AnalyticsEventType = z.output<typeof analyticsEventTypeSchema>;\nexport type IncomingAnalyticsEvent = z.output<\n  typeof incomingAnalyticsEventSchema\n>;\nexport type AudienceRange = z.output<typeof audienceRangeSchema>;\nexport type AudienceGranularity = z.output<typeof audienceGranularitySchema>;\nexport type AudienceSeriesPoint = z.output<typeof audienceSeriesPointSchema>;\nexport type AudienceBreakdownRow = z.output<typeof audienceBreakdownRowSchema>;\nexport type AudienceStats = z.output<typeof audienceStatsSchema>;\nexport type LiveVisitor = z.output<typeof liveVisitorSchema>;\nexport type LiveVisitorFlowStep = z.output<typeof liveVisitorFlowStepSchema>;\nexport type LiveVisitorFlow = z.output<typeof liveVisitorFlowSchema>;\nexport type PageFlowNode = z.output<typeof pageFlowNodeSchema>;\nexport type PageFlowLink = z.output<typeof pageFlowLinkSchema>;\nexport type PageFlow = z.output<typeof pageFlowSchema>;\nexport type AnalyticsOverviewRow = z.output<typeof analyticsOverviewRowSchema>;\nexport type ContentStatRow = z.output<typeof contentStatRowSchema>;\nexport type ExperimentResult = z.output<typeof experimentResultSchema>;\nexport type PageMetadata = z.output<typeof pageMetadataSchema>;\n\nexport type IngestAnalyticsBody = RouteBodyInput<\n  AnalyticsRoutes['ingestAnalyticsEvents']\n>;\nexport type IngestAnalyticsResult = ResponseData<{ accepted: number }>;\nexport type GetAnalyticsOverviewResult = ResponseData<AnalyticsOverviewRow[]>;\nexport type GetContentStatsResult = ResponseData<ContentStatRow[]>;\nexport type GetExperimentResultsResult = ResponseData<ExperimentResult>;\nexport type GetAudienceResult = ResponseData<AudienceStats>;\nexport type GetLiveVisitorFlowResult = ResponseData<LiveVisitorFlow>;\nexport type GetPageFlowResult = ResponseData<PageFlow>;\nexport type GetPageMetadataResult = ResponseData<PageMetadata>;\n"],"mappings":"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"}
+{"version":3,"file":"analytics.mjs","names":[],"sources":["../../src/analytics.ts"],"sourcesContent":["import { z } from 'zod/mini';\nimport {\n  type AnalyticsAnnotation,\n  type AnalyticsReport,\n  type AnalyticsSchemaInfo,\n  analyticsAnnotationSchema,\n  analyticsAnnotationsQuerySchema,\n  analyticsRealtimeReportRequestSchema,\n  analyticsReportRequestSchema,\n  analyticsReportSchema,\n  analyticsSchemaInfoSchema,\n} from './analyticsReport';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBodyInput,\n} from './defineRoute';\nimport { type ResponseData, responseDataSchema } from './responseData';\n\nexport * from './analyticsReport';\n\n/** Kind of analytics event sent by the SDK. */\nexport const analyticsEventTypeSchema = z.enum([\n  'page_view',\n  'content_exposure',\n  'conversion',\n]);\n\n/** One event as sent by the SDK (batched). */\nexport const incomingAnalyticsEventSchema = z.looseObject({\n  type: analyticsEventTypeSchema,\n  /** Client timestamp (epoch ms). */\n  t: z.number(),\n  locale: z.string(),\n  url: z.string(),\n  ref: z.optional(z.string()),\n  dictionaryKey: z.optional(z.string()),\n  keyPath: z.optional(z.string()),\n  nodeType: z.optional(z.string()),\n  variant: z.optional(z.string()),\n  count: z.optional(z.number()),\n  experimentKey: z.optional(z.string()),\n  goal: z.optional(z.string()),\n  value: z.optional(z.number()),\n});\n\n/**\n * Time windows of the audience report. `live` covers the sessions active in the\n * last 30 minutes, bucketed per minute.\n */\nexport const audienceRangeSchema = z.enum([\n  'live',\n  '1h',\n  '24h',\n  '7d',\n  '30d',\n  '90d',\n  '6mo',\n  '1y',\n  '3y',\n]);\n\nexport const audienceGranularitySchema = z.enum([\n  'minute',\n  'hour',\n  'day',\n  'week',\n  'month',\n]);\n\nexport const audienceSeriesPointSchema = z.object({\n  /** ISO bucket start. */\n  bucket: z.string(),\n  users: z.number(),\n  views: z.number(),\n});\n\nconst audienceBreakdownRowSchema = z.object({\n  key: z.string(),\n  users: z.number(),\n  views: z.number(),\n});\n\n/** A session active in the `live` window, placed on the map. */\nexport const liveVisitorSchema = z.object({\n  /** Opaque, non-reversible visitor id (prefix of the hashed session). */\n  visitorId: z.string(),\n  /** ISO country code, `ZZ` when unknown. */\n  country: z.string(),\n  /** City reported by the CDN, when available. */\n  city: z.optional(z.string()),\n  /** City-level latitude (rounded to ~1 km), when available. */\n  latitude: z.optional(z.number()),\n  /** City-level longitude (rounded to ~1 km), when available. */\n  longitude: z.optional(z.number()),\n  /** Locale the visitor is browsing in. */\n  locale: z.optional(z.string()),\n  /** Page of the visitor's latest activity. */\n  currentUrl: z.string(),\n  /** Pages the visitor was active on during the window. */\n  pageCount: z.number(),\n  /** Page views during the window. */\n  views: z.number(),\n  /** ISO date of the visitor's first activity in the window. */\n  firstSeenAt: z.string(),\n  /** ISO date of the visitor's latest activity. */\n  lastSeenAt: z.string(),\n  /** Minutes (`YYYY-MM-DDTHH:mm`, UTC) the visitor was active in, oldest first. */\n  activeMinutes: z.array(z.string()),\n});\n\n/** One step of a live visitor's journey, oldest first. */\nexport const liveVisitorFlowStepSchema = z.object({\n  url: z.string(),\n  locale: z.optional(z.string()),\n  /** ISO date the visitor reached the page. */\n  firstSeenAt: z.string(),\n  /** ISO date of the visitor's latest activity on the page. */\n  lastSeenAt: z.string(),\n  views: z.number(),\n});\n\n/**\n * Page journey of one live visitor over the `live` window. `visitor` is `null`\n * once the session has left the window (not an error: it simply went quiet).\n */\nexport const liveVisitorFlowSchema = z.object({\n  visitor: z.nullable(liveVisitorSchema),\n  steps: z.array(liveVisitorFlowStepSchema),\n});\n\n/**\n * Pseudo-page a session starts from. Used as the flow's starting page, the\n * next step lists the landing pages.\n */\nexport const PAGE_FLOW_ENTRANCE = '(entrance)';\n\n/** One page of a flow step; `url` is `null` for the \"other pages\" bucket. */\nexport const pageFlowNodeSchema = z.object({\n  url: z.nullable(z.string()),\n  /** Average navigations reaching this page at this step. */\n  value: z.number(),\n  /** Part of `value` that left the site from this page (`null` if unknown). */\n  exits: z.nullable(z.number()),\n});\n\n/** Average navigations from a page of one step to a page of the next. */\nexport const pageFlowLinkSchema = z.object({\n  /** Step of the source page; the target is on `fromStep + 1`. */\n  fromStep: z.number(),\n  fromUrl: z.nullable(z.string()),\n  toUrl: z.nullable(z.string()),\n  value: z.number(),\n});\n\n/** Averaged navigation flow starting from one page. */\nexport const pageFlowSchema = z.object({\n  startUrl: z.string(),\n  range: audienceRangeSchema,\n  /** Pages per step, the starting page alone on step 0. */\n  steps: z.array(z.array(pageFlowNodeSchema)),\n  links: z.array(pageFlowLinkSchema),\n});\n\nexport const audienceStatsSchema = z.object({\n  usersToday: z.number(),\n  usersLast7Days: z.number(),\n  usersInRange: z.number(),\n  viewsInRange: z.number(),\n  range: audienceRangeSchema,\n  rangeHours: z.number(),\n  granularity: audienceGranularitySchema,\n  series: z.array(audienceSeriesPointSchema),\n  byLocale: z.array(audienceBreakdownRowSchema),\n  byCountry: z.array(audienceBreakdownRowSchema),\n  byPage: z.array(audienceBreakdownRowSchema),\n  /** Active sessions with their location — `live` range only. */\n  liveVisitors: z.optional(z.array(liveVisitorSchema)),\n  /** First UTC day with collected data (`YYYY-MM-DD`), `null` before any. */\n  dataSince: z.nullable(z.string()),\n});\n\nconst analyticsOverviewRowSchema = z.object({\n  url: z.string(),\n  locale: z.string(),\n  views: z.number(),\n});\n\nconst contentStatRowSchema = z.object({\n  dictionaryKey: z.string(),\n  keyPath: z.string(),\n  locale: z.string(),\n  exposures: z.number(),\n});\n\nconst experimentResultSchema = z.object({\n  experimentKey: z.string(),\n  variants: z.array(\n    z.object({\n      variant: z.string(),\n      exposures: z.number(),\n      conversions: z.number(),\n      conversionRate: z.number(),\n    })\n  ),\n  pValue: z.nullable(z.number()),\n  winner: z.nullable(z.string()),\n});\n\nconst pageMetadataSchema = z.object({\n  title: z.optional(z.string()),\n  description: z.optional(z.string()),\n});\n\n/** REST contract of the `/api/analytics` routes. */\nexport const analyticsContract = defineRouteGroup({\n  prefix: '/api/analytics',\n  tag: 'Analytics',\n  routes: {\n    ingestAnalyticsEvents: defineRoute({\n      method: 'POST',\n      path: '/events',\n      summary: 'Ingest SDK events (public browser token, rate limited)',\n      schemas: {\n        /** Sent as `text/plain` JSON by `navigator.sendBeacon`. */\n        body: z.looseObject({\n          /** Token from `POST /api/public/token` (`analytics:ingest`). */\n          token: z.optional(z.string()),\n          /** @deprecated Superseded by `token`; still accepted. */\n          clientId: z.optional(z.string()),\n          sessionId: z.string(),\n          sdkVersion: z.string(),\n          events: z.array(incomingAnalyticsEventSchema),\n        }),\n        response: {\n          200: responseDataSchema(z.object({ accepted: z.number() })),\n        },\n      },\n    }),\n    getAnalyticsOverview: defineRoute({\n      method: 'GET',\n      path: '/overview',\n      summary: 'Page views per page and locale',\n      schemas: {\n        response: {\n          200: responseDataSchema(z.array(analyticsOverviewRowSchema)),\n        },\n      },\n    }),\n    getAnalyticsAudience: defineRoute({\n      method: 'GET',\n      path: '/audience',\n      summary: 'Audience report over a time window',\n      schemas: {\n        querystring: z.object({\n          range: z.optional(z.string()),\n          /** Legacy: converted to the closest range. */\n          days: z.optional(z.string()),\n        }),\n        response: { 200: responseDataSchema(audienceStatsSchema) },\n      },\n    }),\n    getLiveVisitorFlow: defineRoute({\n      method: 'GET',\n      path: '/audience/live/visitors/:visitorId',\n      summary: 'Page journey of a visitor active in the last 30 minutes',\n      schemas: {\n        params: z.object({\n          visitorId: z.string().check(z.regex(/^[a-f0-9]{16}$/)),\n        }),\n        response: { 200: responseDataSchema(liveVisitorFlowSchema) },\n      },\n    }),\n    getPageFlow: defineRoute({\n      method: 'GET',\n      path: '/page-flow',\n      summary: 'Average page-to-page navigation flow from a starting page',\n      schemas: {\n        querystring: z.object({\n          range: z.optional(z.string()),\n          /** Starting page pathname; defaults to `/`. */\n          startUrl: z.optional(z.string()),\n        }),\n        response: { 200: responseDataSchema(pageFlowSchema) },\n      },\n    }),\n    getContentStats: defineRoute({\n      method: 'GET',\n      path: '/content-stats',\n      summary: 'Content exposures per dictionary key path and locale',\n      schemas: {\n        response: { 200: responseDataSchema(z.array(contentStatRowSchema)) },\n      },\n    }),\n    getExperimentResults: defineRoute({\n      method: 'GET',\n      path: '/experiments/:experimentKey',\n      summary: 'A/B test results of an experiment',\n      schemas: {\n        params: z.object({ experimentKey: z.string().check(z.minLength(1)) }),\n        response: { 200: responseDataSchema(experimentResultSchema) },\n      },\n    }),\n    getAnalyticsSchema: defineRoute({\n      method: 'GET',\n      path: '/schema',\n      summary:\n        'Report dimensions, metrics, their compatibility, retention and experiments',\n      schemas: {\n        response: { 200: responseDataSchema(analyticsSchemaInfoSchema) },\n      },\n    }),\n    runAnalyticsReport: defineRoute({\n      method: 'POST',\n      path: '/report',\n      summary:\n        'Aggregated report: metrics broken down by dimensions over date ranges',\n      schemas: {\n        body: analyticsReportRequestSchema,\n        response: { 200: responseDataSchema(analyticsReportSchema) },\n      },\n    }),\n    runAnalyticsRealtimeReport: defineRoute({\n      method: 'POST',\n      path: '/realtime-report',\n      summary: 'Aggregated activity of the last minutes (up to one hour)',\n      schemas: {\n        body: analyticsRealtimeReportRequestSchema,\n        response: { 200: responseDataSchema(analyticsReportSchema) },\n      },\n    }),\n    getAnalyticsAnnotations: defineRoute({\n      method: 'GET',\n      path: '/annotations',\n      summary:\n        'Dated content and traffic events (dictionary edits, repo syncs, new locales, experiments)',\n      schemas: {\n        querystring: analyticsAnnotationsQuerySchema,\n        response: {\n          200: responseDataSchema(z.array(analyticsAnnotationSchema)),\n        },\n      },\n    }),\n    getPageMetadata: defineRoute({\n      method: 'GET',\n      path: '/page-metadata',\n      summary: 'Title and description of a page of the project',\n      schemas: {\n        querystring: z.object({ url: z.optional(z.string()) }),\n        response: { 200: responseDataSchema(pageMetadataSchema) },\n      },\n    }),\n  },\n});\n\n/** Route definitions of the `/api/analytics` group, by name. */\nexport type AnalyticsRoutes = (typeof analyticsContract)['routes'];\n\nexport type AnalyticsEventType = z.output<typeof analyticsEventTypeSchema>;\nexport type IncomingAnalyticsEvent = z.output<\n  typeof incomingAnalyticsEventSchema\n>;\nexport type AudienceRange = z.output<typeof audienceRangeSchema>;\nexport type AudienceGranularity = z.output<typeof audienceGranularitySchema>;\nexport type AudienceSeriesPoint = z.output<typeof audienceSeriesPointSchema>;\nexport type AudienceBreakdownRow = z.output<typeof audienceBreakdownRowSchema>;\nexport type AudienceStats = z.output<typeof audienceStatsSchema>;\nexport type LiveVisitor = z.output<typeof liveVisitorSchema>;\nexport type LiveVisitorFlowStep = z.output<typeof liveVisitorFlowStepSchema>;\nexport type LiveVisitorFlow = z.output<typeof liveVisitorFlowSchema>;\nexport type PageFlowNode = z.output<typeof pageFlowNodeSchema>;\nexport type PageFlowLink = z.output<typeof pageFlowLinkSchema>;\nexport type PageFlow = z.output<typeof pageFlowSchema>;\nexport type AnalyticsOverviewRow = z.output<typeof analyticsOverviewRowSchema>;\nexport type ContentStatRow = z.output<typeof contentStatRowSchema>;\nexport type ExperimentResult = z.output<typeof experimentResultSchema>;\nexport type PageMetadata = z.output<typeof pageMetadataSchema>;\n\nexport type IngestAnalyticsBody = RouteBodyInput<\n  AnalyticsRoutes['ingestAnalyticsEvents']\n>;\nexport type IngestAnalyticsResult = ResponseData<{ accepted: number }>;\nexport type GetAnalyticsOverviewResult = ResponseData<AnalyticsOverviewRow[]>;\nexport type GetContentStatsResult = ResponseData<ContentStatRow[]>;\nexport type GetExperimentResultsResult = ResponseData<ExperimentResult>;\nexport type GetAudienceResult = ResponseData<AudienceStats>;\nexport type GetLiveVisitorFlowResult = ResponseData<LiveVisitorFlow>;\nexport type GetPageFlowResult = ResponseData<PageFlow>;\nexport type GetPageMetadataResult = ResponseData<PageMetadata>;\nexport type GetAnalyticsSchemaResult = ResponseData<AnalyticsSchemaInfo>;\nexport type RunAnalyticsReportResult = ResponseData<AnalyticsReport>;\nexport type GetAnalyticsAnnotationsResult = ResponseData<AnalyticsAnnotation[]>;\nexport type RunAnalyticsReportBody = RouteBodyInput<\n  AnalyticsRoutes['runAnalyticsReport']\n>;\nexport type RunAnalyticsRealtimeReportBody = RouteBodyInput<\n  AnalyticsRoutes['runAnalyticsRealtimeReport']\n>;\n"],"mappings":"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"}

package/dist/esm/analyticsReport.mjs

@@ -0,0 +1,276 @@
+import { z } from "zod/mini";
+
+// src/analyticsReport.ts
+/**
+* Report dimensions. Time dimensions are labelled `YYYY-MM-DD` (`date`),
+* `YYYY-Www` (`week`, ISO week) and `YYYY-MM` (`month`), all in UTC.
+*/
+const ANALYTICS_REPORT_DIMENSIONS = [
+	"date",
+	"week",
+	"month",
+	"locale",
+	"pagePath",
+	"country",
+	"dictionaryKey",
+	"keyPath",
+	"contentType",
+	"variant",
+	"experimentKey",
+	"goal"
+];
+const ANALYTICS_REPORT_METRICS = [
+	"pageViews",
+	"activeUsers",
+	"entrances",
+	"contentExposures",
+	"conversions",
+	"conversionValue"
+];
+/** Dimensions that bucket time; they cannot be used in dimension filters. */
+const ANALYTICS_TIME_DIMENSIONS = [
+	"date",
+	"week",
+	"month"
+];
+const TIME_DIMENSIONS = ANALYTICS_TIME_DIMENSIONS;
+/**
+* Dimensions each metric can be broken down by. The data is stored
+* pre-aggregated per event type, so a dimension a metric was not recorded with
+* cannot be applied to it (ex: visitors are not attributed per page).
+*/
+const ANALYTICS_METRIC_DIMENSIONS = {
+	pageViews: [
+		...TIME_DIMENSIONS,
+		"locale",
+		"pagePath"
+	],
+	activeUsers: [
+		...TIME_DIMENSIONS,
+		"locale",
+		"country"
+	],
+	entrances: [...TIME_DIMENSIONS, "pagePath"],
+	contentExposures: [
+		...TIME_DIMENSIONS,
+		"locale",
+		"dictionaryKey",
+		"keyPath",
+		"contentType",
+		"variant",
+		"experimentKey"
+	],
+	conversions: [
+		...TIME_DIMENSIONS,
+		"locale",
+		"variant",
+		"experimentKey",
+		"goal"
+	],
+	conversionValue: [
+		...TIME_DIMENSIONS,
+		"locale",
+		"variant",
+		"experimentKey",
+		"goal"
+	]
+};
+const ANALYTICS_DIMENSION_DESCRIPTIONS = {
+	date: "UTC day, `YYYY-MM-DD`.",
+	week: "ISO week, `YYYY-Www` (weeks start on Monday, UTC).",
+	month: "Month, `YYYY-MM` (UTC).",
+	locale: "Locale the content was displayed in (ex: `fr`, `en-GB`).",
+	pagePath: "Page pathname, including any locale prefix (`/fr/pricing`). For `entrances`, the landing page.",
+	country: "ISO 3166-1 alpha-2 visitor country, `ZZ` when unknown.",
+	dictionaryKey: "Intlayer dictionary key of the displayed content.",
+	keyPath: "Path of the displayed field inside its dictionary.",
+	contentType: "Intlayer node type of the displayed field (translation, enumeration, markdown…).",
+	variant: "A/B variant shown.",
+	experimentKey: "A/B experiment key.",
+	goal: "Conversion goal name."
+};
+const ANALYTICS_METRIC_DESCRIPTIONS = {
+	pageViews: "Page views.",
+	activeUsers: "Distinct anonymous visitor sessions (not additive across rows: a visitor seen in two locales counts in both). Kept 400 days.",
+	entrances: "Sessions that started on the page (landing pages).",
+	contentExposures: "Times a content field was displayed.",
+	conversions: "Conversion events.",
+	conversionValue: "Sum of the numeric value attached to conversions."
+};
+const ANALYTICS_REALTIME_DIMENSIONS = [
+	"minute",
+	"pagePath",
+	"locale",
+	"country"
+];
+const ANALYTICS_REALTIME_METRICS = ["activeUsers", "pageViews"];
+/** Retention of the realtime activity, in minutes. */
+const ANALYTICS_REALTIME_MAX_MINUTES = 60;
+/** Retention of the distinct visitor markers behind `activeUsers`, in days. */
+const ANALYTICS_ACTIVE_USERS_RETENTION_DAYS = 400;
+/** Default and maximum number of rows a report returns. */
+const ANALYTICS_REPORT_DEFAULT_LIMIT = 100;
+const ANALYTICS_REPORT_MAX_LIMIT = 1e4;
+/** Maximum date ranges compared in one report. */
+const ANALYTICS_REPORT_MAX_DATE_RANGES = 4;
+/**
+* Date of a report range: `YYYY-MM-DD`, `today`, `yesterday` or `NdaysAgo`
+* (ex: `30daysAgo`). Days are UTC.
+*/
+const relativeDateSchema = z.string().check(z.regex(/^(\d{4}-\d{2}-\d{2}|today|yesterday|\d+daysAgo)$/, "Expected YYYY-MM-DD, today, yesterday or NdaysAgo"));
+const analyticsDateRangeSchema = z.object({
+	startDate: relativeDateSchema,
+	endDate: relativeDateSchema,
+	/** Label of the range in the rows (`dateRange` column) when comparing. */
+	name: z.optional(z.string().check(z.maxLength(64)))
+});
+const dimensionFilterOperatorSchema = z.enum([
+	"exact",
+	"contains",
+	"beginsWith",
+	"endsWith",
+	"inList"
+]);
+const analyticsDimensionFilterSchema = z.object({
+	dimension: z.enum(ANALYTICS_REPORT_DIMENSIONS),
+	operator: dimensionFilterOperatorSchema,
+	/** Compared value (every operator but `inList`). */
+	value: z.optional(z.string().check(z.maxLength(512))),
+	/** Accepted values (`inList`). */
+	values: z.optional(z.array(z.string().check(z.maxLength(512))).check(z.maxLength(100))),
+	/** Defaults to `false`. */
+	caseSensitive: z.optional(z.boolean()),
+	/** Keeps the rows that do NOT match. */
+	not: z.optional(z.boolean())
+});
+const metricFilterOperatorSchema = z.enum([
+	"equal",
+	"greaterThan",
+	"greaterThanOrEqual",
+	"lessThan",
+	"lessThanOrEqual",
+	"between"
+]);
+const analyticsMetricFilterSchema = z.object({
+	metric: z.enum(ANALYTICS_REPORT_METRICS),
+	operator: metricFilterOperatorSchema,
+	value: z.number(),
+	/** Upper bound (inclusive) of `between`. */
+	toValue: z.optional(z.number())
+});
+const analyticsOrderBySchema = z.object({
+	/** A requested dimension or metric, or `dateRange`. */
+	field: z.string(),
+	/** Descending order. Defaults to `true` for metrics, `false` otherwise. */
+	desc: z.optional(z.boolean())
+});
+const analyticsReportRequestSchema = z.object({
+	dateRanges: z.array(analyticsDateRangeSchema).check(z.minLength(1), z.maxLength(4)),
+	dimensions: z._default(z.array(z.enum(ANALYTICS_REPORT_DIMENSIONS)).check(z.maxLength(4)), []),
+	metrics: z.array(z.enum(ANALYTICS_REPORT_METRICS)).check(z.minLength(1), z.maxLength(ANALYTICS_REPORT_METRICS.length)),
+	dimensionFilters: z.optional(z.array(analyticsDimensionFilterSchema).check(z.maxLength(10))),
+	metricFilters: z.optional(z.array(analyticsMetricFilterSchema).check(z.maxLength(10))),
+	orderBys: z.optional(z.array(analyticsOrderBySchema).check(z.maxLength(4))),
+	limit: z.optional(z.number().check(z.int(), z.minimum(1), z.maximum(ANALYTICS_REPORT_MAX_LIMIT))),
+	offset: z.optional(z.number().check(z.int(), z.minimum(0)))
+});
+const analyticsRealtimeReportRequestSchema = z.object({
+	dimensions: z._default(z.array(z.enum(ANALYTICS_REALTIME_DIMENSIONS)).check(z.maxLength(3)), []),
+	metrics: z.array(z.enum(ANALYTICS_REALTIME_METRICS)).check(z.minLength(1), z.maxLength(ANALYTICS_REALTIME_METRICS.length)),
+	/** Window, in minutes before now. Defaults to 30. */
+	minutesAgo: z.optional(z.number().check(z.int(), z.minimum(1), z.maximum(60))),
+	dimensionFilters: z.optional(z.array(z.object({
+		dimension: z.enum(ANALYTICS_REALTIME_DIMENSIONS),
+		operator: dimensionFilterOperatorSchema,
+		value: z.optional(z.string().check(z.maxLength(512))),
+		values: z.optional(z.array(z.string().check(z.maxLength(512))).check(z.maxLength(100))),
+		caseSensitive: z.optional(z.boolean()),
+		not: z.optional(z.boolean())
+	})).check(z.maxLength(10))),
+	limit: z.optional(z.number().check(z.int(), z.minimum(1), z.maximum(ANALYTICS_REPORT_MAX_LIMIT)))
+});
+/** A report row: dimension values (strings) and metric values (numbers). */
+const analyticsReportRowSchema = z.record(z.string(), z.union([z.string(), z.number()]));
+const analyticsReportSchema = z.object({
+	dimensions: z.array(z.string()),
+	metrics: z.array(z.string()),
+	/** Resolved ranges (absolute UTC days), in request order. */
+	dateRanges: z.array(z.object({
+		name: z.string(),
+		startDate: z.string(),
+		endDate: z.string()
+	})),
+	rows: z.array(analyticsReportRowSchema),
+	/** Rows matching the filters, before `offset` / `limit`. */
+	rowCount: z.number(),
+	/** Per date range totals, ignoring `metricFilters`. */
+	totals: z.array(analyticsReportRowSchema),
+	metadata: z.object({
+		timeZone: z.literal("UTC"),
+		/** First UTC day with collected data, `null` before any. */
+		dataSince: z.nullable(z.string()),
+		/** Rows were left out by `limit` / `offset`. */
+		truncated: z.boolean(),
+		/** Caveats the reader should know about (retention, sampling…). */
+		warnings: z.array(z.string())
+	})
+});
+const analyticsSchemaInfoSchema = z.object({
+	timeZone: z.literal("UTC"),
+	dataSince: z.nullable(z.string()),
+	/** Locales configured on the project. */
+	locales: z.array(z.string()),
+	retention: z.object({
+		activeUsersDays: z.number(),
+		realtimeMinutes: z.number()
+	}),
+	dimensions: z.array(z.object({
+		name: z.string(),
+		description: z.string()
+	})),
+	metrics: z.array(z.object({
+		name: z.string(),
+		description: z.string(),
+		compatibleDimensions: z.array(z.string())
+	})),
+	realtime: z.object({
+		dimensions: z.array(z.string()),
+		metrics: z.array(z.string())
+	}),
+	/** Experiments with collected data, with the goals converted on. */
+	experiments: z.array(z.object({
+		experimentKey: z.string(),
+		variants: z.array(z.string()),
+		goals: z.array(z.string()),
+		firstSeen: z.string()
+	}))
+});
+const ANALYTICS_ANNOTATION_TYPES = [
+	"dictionary_created",
+	"content_version_created",
+	"dictionary_updated",
+	"source_synced",
+	"locale_first_traffic",
+	"experiment_started"
+];
+const analyticsAnnotationSchema = z.object({
+	/** ISO date-time, or the UTC day for traffic-derived annotations. */
+	date: z.string(),
+	type: z.enum(ANALYTICS_ANNOTATION_TYPES),
+	title: z.string(),
+	dictionaryKey: z.optional(z.string()),
+	locale: z.optional(z.string()),
+	experimentKey: z.optional(z.string()),
+	/** Link to the commit / pull request (`source_synced`). */
+	url: z.optional(z.string())
+});
+const analyticsAnnotationsQuerySchema = z.object({
+	/** `YYYY-MM-DD`, `today`, `yesterday` or `NdaysAgo`. Defaults to 90daysAgo. */
+	startDate: z.optional(relativeDateSchema),
+	endDate: z.optional(relativeDateSchema),
+	types: z.optional(z.string()),
+	limit: z.optional(z.string())
+});
+
+export { ANALYTICS_ACTIVE_USERS_RETENTION_DAYS, ANALYTICS_ANNOTATION_TYPES, ANALYTICS_DIMENSION_DESCRIPTIONS, ANALYTICS_METRIC_DESCRIPTIONS, ANALYTICS_METRIC_DIMENSIONS, ANALYTICS_REALTIME_DIMENSIONS, ANALYTICS_REALTIME_MAX_MINUTES, ANALYTICS_REALTIME_METRICS, ANALYTICS_REPORT_DEFAULT_LIMIT, ANALYTICS_REPORT_DIMENSIONS, ANALYTICS_REPORT_MAX_DATE_RANGES, ANALYTICS_REPORT_MAX_LIMIT, ANALYTICS_REPORT_METRICS, ANALYTICS_TIME_DIMENSIONS, analyticsAnnotationSchema, analyticsAnnotationsQuerySchema, analyticsDateRangeSchema, analyticsDimensionFilterSchema, analyticsMetricFilterSchema, analyticsOrderBySchema, analyticsRealtimeReportRequestSchema, analyticsReportRequestSchema, analyticsReportRowSchema, analyticsReportSchema, analyticsSchemaInfoSchema };
+//# sourceMappingURL=analyticsReport.mjs.map

package/dist/esm/analyticsReport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyticsReport.mjs","names":[],"sources":["../../src/analyticsReport.ts"],"sourcesContent":["import { z } from 'zod/mini';\n\n/**\n * Report dimensions. Time dimensions are labelled `YYYY-MM-DD` (`date`),\n * `YYYY-Www` (`week`, ISO week) and `YYYY-MM` (`month`), all in UTC.\n */\nexport const ANALYTICS_REPORT_DIMENSIONS = [\n  'date',\n  'week',\n  'month',\n  'locale',\n  'pagePath',\n  'country',\n  'dictionaryKey',\n  'keyPath',\n  'contentType',\n  'variant',\n  'experimentKey',\n  'goal',\n] as const;\n\nexport const ANALYTICS_REPORT_METRICS = [\n  'pageViews',\n  'activeUsers',\n  'entrances',\n  'contentExposures',\n  'conversions',\n  'conversionValue',\n] as const;\n\nexport type AnalyticsReportDimension =\n  (typeof ANALYTICS_REPORT_DIMENSIONS)[number];\nexport type AnalyticsReportMetric = (typeof ANALYTICS_REPORT_METRICS)[number];\n\n/** Dimensions that bucket time; they cannot be used in dimension filters. */\nexport const ANALYTICS_TIME_DIMENSIONS = [\n  'date',\n  'week',\n  'month',\n] as const satisfies readonly AnalyticsReportDimension[];\n\nconst TIME_DIMENSIONS = ANALYTICS_TIME_DIMENSIONS;\n\n/**\n * Dimensions each metric can be broken down by. The data is stored\n * pre-aggregated per event type, so a dimension a metric was not recorded with\n * cannot be applied to it (ex: visitors are not attributed per page).\n */\nexport const ANALYTICS_METRIC_DIMENSIONS = {\n  pageViews: [...TIME_DIMENSIONS, 'locale', 'pagePath'],\n  activeUsers: [...TIME_DIMENSIONS, 'locale', 'country'],\n  entrances: [...TIME_DIMENSIONS, 'pagePath'],\n  contentExposures: [\n    ...TIME_DIMENSIONS,\n    'locale',\n    'dictionaryKey',\n    'keyPath',\n    'contentType',\n    'variant',\n    'experimentKey',\n  ],\n  conversions: [\n    ...TIME_DIMENSIONS,\n    'locale',\n    'variant',\n    'experimentKey',\n    'goal',\n  ],\n  conversionValue: [\n    ...TIME_DIMENSIONS,\n    'locale',\n    'variant',\n    'experimentKey',\n    'goal',\n  ],\n} as const satisfies Record<\n  AnalyticsReportMetric,\n  readonly AnalyticsReportDimension[]\n>;\n\nexport const ANALYTICS_DIMENSION_DESCRIPTIONS: Record<\n  AnalyticsReportDimension,\n  string\n> = {\n  date: 'UTC day, `YYYY-MM-DD`.',\n  week: 'ISO week, `YYYY-Www` (weeks start on Monday, UTC).',\n  month: 'Month, `YYYY-MM` (UTC).',\n  locale: 'Locale the content was displayed in (ex: `fr`, `en-GB`).',\n  pagePath:\n    'Page pathname, including any locale prefix (`/fr/pricing`). For `entrances`, the landing page.',\n  country: 'ISO 3166-1 alpha-2 visitor country, `ZZ` when unknown.',\n  dictionaryKey: 'Intlayer dictionary key of the displayed content.',\n  keyPath: 'Path of the displayed field inside its dictionary.',\n  contentType:\n    'Intlayer node type of the displayed field (translation, enumeration, markdown…).',\n  variant: 'A/B variant shown.',\n  experimentKey: 'A/B experiment key.',\n  goal: 'Conversion goal name.',\n};\n\nexport const ANALYTICS_METRIC_DESCRIPTIONS: Record<\n  AnalyticsReportMetric,\n  string\n> = {\n  pageViews: 'Page views.',\n  activeUsers:\n    'Distinct anonymous visitor sessions (not additive across rows: a visitor seen in two locales counts in both). Kept 400 days.',\n  entrances: 'Sessions that started on the page (landing pages).',\n  contentExposures: 'Times a content field was displayed.',\n  conversions: 'Conversion events.',\n  conversionValue: 'Sum of the numeric value attached to conversions.',\n};\n\nexport const ANALYTICS_REALTIME_DIMENSIONS = [\n  'minute',\n  'pagePath',\n  'locale',\n  'country',\n] as const;\n\nexport const ANALYTICS_REALTIME_METRICS = ['activeUsers', 'pageViews'] as const;\n\nexport type AnalyticsRealtimeDimension =\n  (typeof ANALYTICS_REALTIME_DIMENSIONS)[number];\nexport type AnalyticsRealtimeMetric =\n  (typeof ANALYTICS_REALTIME_METRICS)[number];\n\n/** Retention of the realtime activity, in minutes. */\nexport const ANALYTICS_REALTIME_MAX_MINUTES = 60;\n/** Retention of the distinct visitor markers behind `activeUsers`, in days. */\nexport const ANALYTICS_ACTIVE_USERS_RETENTION_DAYS = 400;\n/** Default and maximum number of rows a report returns. */\nexport const ANALYTICS_REPORT_DEFAULT_LIMIT = 100;\nexport const ANALYTICS_REPORT_MAX_LIMIT = 10_000;\n/** Maximum date ranges compared in one report. */\nexport const ANALYTICS_REPORT_MAX_DATE_RANGES = 4;\n\n/**\n * Date of a report range: `YYYY-MM-DD`, `today`, `yesterday` or `NdaysAgo`\n * (ex: `30daysAgo`). Days are UTC.\n */\nconst relativeDateSchema = z\n  .string()\n  .check(\n    z.regex(\n      /^(\\d{4}-\\d{2}-\\d{2}|today|yesterday|\\d+daysAgo)$/,\n      'Expected YYYY-MM-DD, today, yesterday or NdaysAgo'\n    )\n  );\n\nexport const analyticsDateRangeSchema = z.object({\n  startDate: relativeDateSchema,\n  endDate: relativeDateSchema,\n  /** Label of the range in the rows (`dateRange` column) when comparing. */\n  name: z.optional(z.string().check(z.maxLength(64))),\n});\n\nconst dimensionFilterOperatorSchema = z.enum([\n  'exact',\n  'contains',\n  'beginsWith',\n  'endsWith',\n  'inList',\n]);\n\nexport const analyticsDimensionFilterSchema = z.object({\n  dimension: z.enum(ANALYTICS_REPORT_DIMENSIONS),\n  operator: dimensionFilterOperatorSchema,\n  /** Compared value (every operator but `inList`). */\n  value: z.optional(z.string().check(z.maxLength(512))),\n  /** Accepted values (`inList`). */\n  values: z.optional(\n    z.array(z.string().check(z.maxLength(512))).check(z.maxLength(100))\n  ),\n  /** Defaults to `false`. */\n  caseSensitive: z.optional(z.boolean()),\n  /** Keeps the rows that do NOT match. */\n  not: z.optional(z.boolean()),\n});\n\nconst metricFilterOperatorSchema = z.enum([\n  'equal',\n  'greaterThan',\n  'greaterThanOrEqual',\n  'lessThan',\n  'lessThanOrEqual',\n  'between',\n]);\n\nexport const analyticsMetricFilterSchema = z.object({\n  metric: z.enum(ANALYTICS_REPORT_METRICS),\n  operator: metricFilterOperatorSchema,\n  value: z.number(),\n  /** Upper bound (inclusive) of `between`. */\n  toValue: z.optional(z.number()),\n});\n\nexport const analyticsOrderBySchema = z.object({\n  /** A requested dimension or metric, or `dateRange`. */\n  field: z.string(),\n  /** Descending order. Defaults to `true` for metrics, `false` otherwise. */\n  desc: z.optional(z.boolean()),\n});\n\nexport const analyticsReportRequestSchema = z.object({\n  dateRanges: z\n    .array(analyticsDateRangeSchema)\n    .check(z.minLength(1), z.maxLength(ANALYTICS_REPORT_MAX_DATE_RANGES)),\n  dimensions: z._default(\n    z.array(z.enum(ANALYTICS_REPORT_DIMENSIONS)).check(z.maxLength(4)),\n    []\n  ),\n  metrics: z\n    .array(z.enum(ANALYTICS_REPORT_METRICS))\n    .check(z.minLength(1), z.maxLength(ANALYTICS_REPORT_METRICS.length)),\n  dimensionFilters: z.optional(\n    z.array(analyticsDimensionFilterSchema).check(z.maxLength(10))\n  ),\n  metricFilters: z.optional(\n    z.array(analyticsMetricFilterSchema).check(z.maxLength(10))\n  ),\n  orderBys: z.optional(z.array(analyticsOrderBySchema).check(z.maxLength(4))),\n  limit: z.optional(\n    z\n      .number()\n      .check(z.int(), z.minimum(1), z.maximum(ANALYTICS_REPORT_MAX_LIMIT))\n  ),\n  offset: z.optional(z.number().check(z.int(), z.minimum(0))),\n});\n\nexport const analyticsRealtimeReportRequestSchema = z.object({\n  dimensions: z._default(\n    z.array(z.enum(ANALYTICS_REALTIME_DIMENSIONS)).check(z.maxLength(3)),\n    []\n  ),\n  metrics: z\n    .array(z.enum(ANALYTICS_REALTIME_METRICS))\n    .check(z.minLength(1), z.maxLength(ANALYTICS_REALTIME_METRICS.length)),\n  /** Window, in minutes before now. Defaults to 30. */\n  minutesAgo: z.optional(\n    z\n      .number()\n      .check(z.int(), z.minimum(1), z.maximum(ANALYTICS_REALTIME_MAX_MINUTES))\n  ),\n  dimensionFilters: z.optional(\n    z\n      .array(\n        z.object({\n          dimension: z.enum(ANALYTICS_REALTIME_DIMENSIONS),\n          operator: dimensionFilterOperatorSchema,\n          value: z.optional(z.string().check(z.maxLength(512))),\n          values: z.optional(\n            z.array(z.string().check(z.maxLength(512))).check(z.maxLength(100))\n          ),\n          caseSensitive: z.optional(z.boolean()),\n          not: z.optional(z.boolean()),\n        })\n      )\n      .check(z.maxLength(10))\n  ),\n  limit: z.optional(\n    z\n      .number()\n      .check(z.int(), z.minimum(1), z.maximum(ANALYTICS_REPORT_MAX_LIMIT))\n  ),\n});\n\n/** A report row: dimension values (strings) and metric values (numbers). */\nexport const analyticsReportRowSchema = z.record(\n  z.string(),\n  z.union([z.string(), z.number()])\n);\n\nexport const analyticsReportSchema = z.object({\n  dimensions: z.array(z.string()),\n  metrics: z.array(z.string()),\n  /** Resolved ranges (absolute UTC days), in request order. */\n  dateRanges: z.array(\n    z.object({ name: z.string(), startDate: z.string(), endDate: z.string() })\n  ),\n  rows: z.array(analyticsReportRowSchema),\n  /** Rows matching the filters, before `offset` / `limit`. */\n  rowCount: z.number(),\n  /** Per date range totals, ignoring `metricFilters`. */\n  totals: z.array(analyticsReportRowSchema),\n  metadata: z.object({\n    timeZone: z.literal('UTC'),\n    /** First UTC day with collected data, `null` before any. */\n    dataSince: z.nullable(z.string()),\n    /** Rows were left out by `limit` / `offset`. */\n    truncated: z.boolean(),\n    /** Caveats the reader should know about (retention, sampling…). */\n    warnings: z.array(z.string()),\n  }),\n});\n\nexport const analyticsSchemaInfoSchema = z.object({\n  timeZone: z.literal('UTC'),\n  dataSince: z.nullable(z.string()),\n  /** Locales configured on the project. */\n  locales: z.array(z.string()),\n  retention: z.object({\n    activeUsersDays: z.number(),\n    realtimeMinutes: z.number(),\n  }),\n  dimensions: z.array(z.object({ name: z.string(), description: z.string() })),\n  metrics: z.array(\n    z.object({\n      name: z.string(),\n      description: z.string(),\n      compatibleDimensions: z.array(z.string()),\n    })\n  ),\n  realtime: z.object({\n    dimensions: z.array(z.string()),\n    metrics: z.array(z.string()),\n  }),\n  /** Experiments with collected data, with the goals converted on. */\n  experiments: z.array(\n    z.object({\n      experimentKey: z.string(),\n      variants: z.array(z.string()),\n      goals: z.array(z.string()),\n      firstSeen: z.string(),\n    })\n  ),\n});\n\nexport const ANALYTICS_ANNOTATION_TYPES = [\n  'dictionary_created',\n  'content_version_created',\n  'dictionary_updated',\n  'source_synced',\n  'locale_first_traffic',\n  'experiment_started',\n] as const;\n\nexport const analyticsAnnotationSchema = z.object({\n  /** ISO date-time, or the UTC day for traffic-derived annotations. */\n  date: z.string(),\n  type: z.enum(ANALYTICS_ANNOTATION_TYPES),\n  title: z.string(),\n  dictionaryKey: z.optional(z.string()),\n  locale: z.optional(z.string()),\n  experimentKey: z.optional(z.string()),\n  /** Link to the commit / pull request (`source_synced`). */\n  url: z.optional(z.string()),\n});\n\nexport const analyticsAnnotationsQuerySchema = z.object({\n  /** `YYYY-MM-DD`, `today`, `yesterday` or `NdaysAgo`. Defaults to 90daysAgo. */\n  startDate: z.optional(relativeDateSchema),\n  endDate: z.optional(relativeDateSchema),\n  types: z.optional(z.string()),\n  limit: z.optional(z.string()),\n});\n\nexport type AnalyticsDateRange = z.output<typeof analyticsDateRangeSchema>;\nexport type AnalyticsDimensionFilter = z.output<\n  typeof analyticsDimensionFilterSchema\n>;\nexport type AnalyticsMetricFilter = z.output<\n  typeof analyticsMetricFilterSchema\n>;\nexport type AnalyticsOrderBy = z.output<typeof analyticsOrderBySchema>;\nexport type AnalyticsReportRequest = z.input<\n  typeof analyticsReportRequestSchema\n>;\nexport type AnalyticsRealtimeReportRequest = z.input<\n  typeof analyticsRealtimeReportRequestSchema\n>;\nexport type AnalyticsReportRow = z.output<typeof analyticsReportRowSchema>;\nexport type AnalyticsReport = z.output<typeof analyticsReportSchema>;\nexport type AnalyticsSchemaInfo = z.output<typeof analyticsSchemaInfoSchema>;\nexport type AnalyticsAnnotationType =\n  (typeof ANALYTICS_ANNOTATION_TYPES)[number];\nexport type AnalyticsAnnotation = z.output<typeof analyticsAnnotationSchema>;\nexport type AnalyticsAnnotationsQuery = z.output<\n  typeof analyticsAnnotationsQuerySchema\n>;\n"],"mappings":"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"}