@intlayer/backend-contract 0.0.0-stage → 9.6.0

package/dist/esm/environment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.mjs","names":[],"sources":["../../src/environment.ts"],"sourcesContent":["import { z } from 'zod/mini';\nimport { objectIdSchema } from './common';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBodyInput,\n  type RouteParams,\n} from './defineRoute';\nimport {\n  type EnvironmentAPI,\n  environmentSchema,\n  projectConfigurationSchema,\n} from './project';\nimport { type ResponseData, responseDataSchema } from './responseData';\n\nconst environmentIdParamsSchema = z.object({ environmentId: objectIdSchema });\n\n/** Every environment of the project, production first when virtual. */\nconst environmentsResponseSchema = responseDataSchema(\n  z.array(environmentSchema)\n);\n\n/** REST contract of the `/api/project/environment` routes. */\nexport const environmentContract = defineRouteGroup({\n  prefix: '/api/project/environment',\n  tag: 'Environment',\n  routes: {\n    addEnvironment: defineRoute({\n      method: 'POST',\n      path: '/',\n      summary: 'Create an environment in the selected project',\n      schemas: {\n        body: z.object({\n          name: z.string(),\n          configuration: z.optional(projectConfigurationSchema),\n        }),\n        response: { 200: environmentsResponseSchema },\n      },\n    }),\n    updateEnvironment: defineRoute({\n      method: 'PUT',\n      path: '/:environmentId',\n      summary: 'Rename or reconfigure an environment',\n      schemas: {\n        params: environmentIdParamsSchema,\n        body: z.object({\n          name: z.optional(z.string()),\n          configuration: z.optional(projectConfigurationSchema),\n        }),\n        response: { 200: environmentsResponseSchema },\n      },\n    }),\n    deleteEnvironment: defineRoute({\n      method: 'DELETE',\n      path: '/:environmentId',\n      summary: 'Delete an environment',\n      schemas: {\n        params: environmentIdParamsSchema,\n        response: { 200: environmentsResponseSchema },\n      },\n    }),\n    resetToProductionEnvironment: defineRoute({\n      method: 'PUT',\n      path: '/production/select',\n      summary: 'Select the production environment for the session',\n      schemas: {\n        response: { 200: responseDataSchema(z.nullable(environmentSchema)) },\n      },\n    }),\n    selectEnvironment: defineRoute({\n      method: 'PUT',\n      path: '/:environmentId/select',\n      summary: 'Select an environment for the session',\n      schemas: {\n        params: environmentIdParamsSchema,\n        response: { 200: responseDataSchema(environmentSchema) },\n      },\n    }),\n    migrateEnvironment: defineRoute({\n      method: 'POST',\n      path: '/migrate',\n      summary: 'Copy dictionaries and configuration between environments',\n      schemas: {\n        body: z.object({\n          /** Environment id, or `production` for the default environment. */\n          sourceEnvironmentId: z.string(),\n          targetEnvironmentId: z.string(),\n          strategy: z.enum(['overwrite', 'fill-missing']),\n          migrateContent: z.optional(z.boolean()),\n          migrateConfiguration: z.optional(z.boolean()),\n        }),\n        response: {\n          200: responseDataSchema(\n            z.object({\n              migratedDictionaries: z.number(),\n              skippedDictionaries: z.number(),\n              configurationMigrated: z.boolean(),\n            })\n          ),\n        },\n      },\n    }),\n  },\n});\n\n/** Route definitions of the `/api/project/environment` group, by name. */\nexport type EnvironmentRoutes = (typeof environmentContract)['routes'];\n\nexport type AddEnvironmentBody = RouteBodyInput<\n  EnvironmentRoutes['addEnvironment']\n>;\nexport type AddEnvironmentResult = ResponseData<EnvironmentAPI[]>;\nexport type UpdateEnvironmentParams = RouteParams<\n  EnvironmentRoutes['updateEnvironment']\n>;\nexport type UpdateEnvironmentBody = RouteBodyInput<\n  EnvironmentRoutes['updateEnvironment']\n>;\nexport type UpdateEnvironmentResult = ResponseData<EnvironmentAPI[]>;\nexport type DeleteEnvironmentParams = RouteParams<\n  EnvironmentRoutes['deleteEnvironment']\n>;\nexport type DeleteEnvironmentResult = ResponseData<EnvironmentAPI[]>;\nexport type SelectEnvironmentParams = RouteParams<\n  EnvironmentRoutes['selectEnvironment']\n>;\nexport type SelectEnvironmentResult = ResponseData<EnvironmentAPI>;\nexport type ResetToProductionEnvironmentResult =\n  ResponseData<EnvironmentAPI | null>;\nexport type MigrateEnvironmentBody = RouteBodyInput<\n  EnvironmentRoutes['migrateEnvironment']\n>;\nexport type MigrateEnvironmentResult = ResponseData<{\n  migratedDictionaries: number;\n  skippedDictionaries: number;\n  configurationMigrated: boolean;\n}>;\n"],"mappings":";;;;;;;AAeA,MAAM,4BAA4B,EAAE,OAAO,EAAE,eAAe,eAAe,CAAC;;AAG5E,MAAM,6BAA6B,mBACjC,EAAE,MAAM,iBAAiB,CAC3B;;AAGA,MAAa,sBAAsB,iBAAiB;CAClD,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,gBAAgB,YAAY;GAC1B,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;IACP,MAAM,EAAE,OAAO;KACb,MAAM,EAAE,OAAO;KACf,eAAe,EAAE,SAAS,0BAA0B;IACtD,CAAC;IACD,UAAU,EAAE,KAAK,2BAA2B;GAC9C;EACF,CAAC;EACD,mBAAmB,YAAY;GAC7B,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;IACP,QAAQ;IACR,MAAM,EAAE,OAAO;KACb,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;KAC3B,eAAe,EAAE,SAAS,0BAA0B;IACtD,CAAC;IACD,UAAU,EAAE,KAAK,2BAA2B;GAC9C;EACF,CAAC;EACD,mBAAmB,YAAY;GAC7B,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;IACP,QAAQ;IACR,UAAU,EAAE,KAAK,2BAA2B;GAC9C;EACF,CAAC;EACD,8BAA8B,YAAY;GACxC,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS,EACP,UAAU,EAAE,KAAK,mBAAmB,EAAE,SAAS,iBAAiB,CAAC,EAAE,EACrE;EACF,CAAC;EACD,mBAAmB,YAAY;GAC7B,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;IACP,QAAQ;IACR,UAAU,EAAE,KAAK,mBAAmB,iBAAiB,EAAE;GACzD;EACF,CAAC;EACD,oBAAoB,YAAY;GAC9B,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;IACP,MAAM,EAAE,OAAO;;KAEb,qBAAqB,EAAE,OAAO;KAC9B,qBAAqB,EAAE,OAAO;KAC9B,UAAU,EAAE,KAAK,CAAC,aAAa,cAAc,CAAC;KAC9C,gBAAgB,EAAE,SAAS,EAAE,QAAQ,CAAC;KACtC,sBAAsB,EAAE,SAAS,EAAE,QAAQ,CAAC;IAC9C,CAAC;IACD,UAAU,EACR,KAAK,mBACH,EAAE,OAAO;KACP,sBAAsB,EAAE,OAAO;KAC/B,qBAAqB,EAAE,OAAO;KAC9B,uBAAuB,EAAE,QAAQ;IACnC,CAAC,CACH,EACF;GACF;EACF,CAAC;CACH;AACF,CAAC"}

package/dist/esm/eventListener.mjs

@@ -0,0 +1,18 @@
+import { defineRoute, defineRouteGroup } from "./defineRoute.mjs";
+
+//#region src/eventListener.ts
+/** Live dictionary change stream (server-sent events). */
+const eventListenerContract = defineRouteGroup({
+	prefix: "/api/event-listener",
+	tag: "Event listener",
+	routes: { checkDictionaryChangeSSE: defineRoute({
+		method: "GET",
+		path: "/",
+		summary: "Stream dictionary changes of the project (server-sent events)",
+		schemas: {}
+	}) }
+});
+
+//#endregion
+export { eventListenerContract };
+//# sourceMappingURL=eventListener.mjs.map

package/dist/esm/eventListener.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventListener.mjs","names":[],"sources":["../../src/eventListener.ts"],"sourcesContent":["import { defineRoute, defineRouteGroup } from './defineRoute';\nimport type { DictionaryAPI } from './dictionary';\n\n/** Live dictionary change stream (server-sent events). */\nexport const eventListenerContract = defineRouteGroup({\n  prefix: '/api/event-listener',\n  tag: 'Event listener',\n  routes: {\n    checkDictionaryChangeSSE: defineRoute({\n      method: 'GET',\n      path: '/',\n      summary: 'Stream dictionary changes of the project (server-sent events)',\n      schemas: {},\n    }),\n  },\n});\n\n/** Route definitions of the event listener group, by name. */\nexport type EventListenerRoutes = (typeof eventListenerContract)['routes'];\n\n/** Message pushed on the dictionary change stream. */\nexport type MessageEventData = {\n  object: 'DICTIONARY';\n  status: 'ADDED' | 'UPDATED' | 'DELETED' | 'CREATED';\n  data: DictionaryAPI;\n};\n"],"mappings":";;;;AAIA,MAAa,wBAAwB,iBAAiB;CACpD,QAAQ;CACR,KAAK;CACL,QAAQ,EACN,0BAA0B,YAAY;EACpC,QAAQ;EACR,MAAM;EACN,SAAS;EACT,SAAS,CAAC;CACZ,CAAC,EACH;AACF,CAAC"}

package/dist/esm/gitProviders.mjs

@@ -0,0 +1,352 @@
+import { defineRoute, defineRouteGroup } from "./defineRoute.mjs";
+import { responseDataSchema } from "./responseData.mjs";
+import { z } from "zod/mini";
+
+//#region src/gitProviders.ts
+/**
+* Git provider OAuth + repository routes (repository linking in the
+* dashboard). Each provider gets its own group; the shapes below are shared.
+*/
+const authUrlResponseSchema = responseDataSchema(z.object({ authUrl: z.string() }));
+const tokenResponseSchema = responseDataSchema(z.object({ token: z.string() }));
+const checkConfigResponseSchema = responseDataSchema(z.object({
+	hasConfig: z.boolean(),
+	configPaths: z.array(z.string())
+}));
+const configFileResponseSchema = responseDataSchema(z.object({ content: z.string() }));
+/** Optional provider token: defaults to the one linked to the user. */
+const tokenShape = { token: z.optional(z.string()) };
+const branchAndPathShape = {
+	branch: z.optional(z.string()),
+	path: z.optional(z.string())
+};
+/** GitHub repository (subset of the REST API item the dashboard reads). */
+const gitHubRepositorySchema = z.looseObject({
+	id: z.number(),
+	name: z.string(),
+	full_name: z.string(),
+	owner: z.looseObject({
+		login: z.string(),
+		avatar_url: z.optional(z.string())
+	}),
+	private: z.boolean(),
+	html_url: z.string(),
+	default_branch: z.optional(z.string()),
+	updated_at: z.optional(z.nullable(z.string()))
+});
+/** GitLab project (subset the dashboard reads). */
+const gitLabProjectSchema = z.looseObject({
+	id: z.number(),
+	name: z.string(),
+	path_with_namespace: z.string(),
+	web_url: z.string(),
+	default_branch: z.string(),
+	visibility: z.string(),
+	last_activity_at: z.string(),
+	namespace: z.looseObject({
+		id: z.number(),
+		name: z.string(),
+		path: z.string()
+	})
+});
+/** Bitbucket repository (subset the dashboard reads). */
+const bitbucketRepositorySchema = z.looseObject({
+	uuid: z.string(),
+	name: z.string(),
+	full_name: z.string(),
+	slug: z.string(),
+	mainbranch: z.optional(z.looseObject({
+		name: z.string(),
+		type: z.string()
+	})),
+	links: z.looseObject({ html: z.looseObject({ href: z.string() }) }),
+	workspace: z.looseObject({
+		slug: z.string(),
+		name: z.string(),
+		uuid: z.string()
+	}),
+	is_private: z.optional(z.boolean()),
+	updated_on: z.optional(z.string())
+});
+/**
+* Repository of a Gitea-compatible forge (Codeberg/Forgejo, Gitee), normalized
+* by the backend. `name` is the URL slug used in API paths.
+*/
+const forgeRepositorySchema = z.object({
+	id: z.number(),
+	name: z.string(),
+	/** Human-readable name (can differ from the slug on Gitee). */
+	displayName: z.string(),
+	full_name: z.string(),
+	owner: z.object({
+		login: z.string(),
+		avatar_url: z.optional(z.string())
+	}),
+	private: z.boolean(),
+	html_url: z.string(),
+	default_branch: z.optional(z.string()),
+	updated_at: z.optional(z.nullable(z.string()))
+});
+const forgeRepositoryShape = {
+	...tokenShape,
+	owner: z.string(),
+	repository: z.string()
+};
+/**
+* Builds the contract of a Gitea-compatible forge: repositories are listed and
+* read with the account linked through better-auth.
+*/
+const defineForgeContract = (prefix, tag) => defineRouteGroup({
+	prefix,
+	tag,
+	routes: {
+		listRepos: defineRoute({
+			method: "GET",
+			path: "/repos",
+			summary: `Repositories of the ${tag} account`,
+			schemas: {
+				querystring: z.object(tokenShape),
+				response: { 200: responseDataSchema(z.array(forgeRepositorySchema)) }
+			}
+		}),
+		checkConfig: defineRoute({
+			method: "POST",
+			path: "/check-config",
+			summary: "Find Intlayer configuration files in a repository",
+			schemas: {
+				body: z.object({
+					...forgeRepositoryShape,
+					branch: z.optional(z.string())
+				}),
+				response: { 200: checkConfigResponseSchema }
+			}
+		}),
+		getConfigFile: defineRoute({
+			method: "POST",
+			path: "/get-config-file",
+			summary: "Read an Intlayer configuration file of a repository",
+			schemas: {
+				body: z.object({
+					...forgeRepositoryShape,
+					...branchAndPathShape
+				}),
+				response: { 200: configFileResponseSchema }
+			}
+		})
+	}
+});
+/** REST contract of the `/api/codeberg` routes (Codeberg / Forgejo). */
+const codebergContract = defineForgeContract("/api/codeberg", "Codeberg");
+/** REST contract of the `/api/gitee` routes. */
+const giteeContract = defineForgeContract("/api/gitee", "Gitee");
+/** REST contract of the `/api/github` routes. */
+const githubContract = defineRouteGroup({
+	prefix: "/api/github",
+	tag: "GitHub",
+	routes: {
+		getAuthUrl: defineRoute({
+			method: "GET",
+			path: "/auth-url",
+			summary: "GitHub OAuth authorization URL",
+			schemas: {
+				querystring: z.object({
+					redirectUri: z.string(),
+					login: z.optional(z.string())
+				}),
+				response: { 200: authUrlResponseSchema }
+			}
+		}),
+		authCallback: defineRoute({
+			method: "POST",
+			path: "/auth",
+			summary: "Exchange the OAuth code for a GitHub token",
+			schemas: {
+				body: z.object({ code: z.string() }),
+				response: { 200: tokenResponseSchema }
+			}
+		}),
+		listRepos: defineRoute({
+			method: "GET",
+			path: "/repos",
+			summary: "Repositories of the GitHub account",
+			schemas: {
+				querystring: z.object(tokenShape),
+				response: { 200: responseDataSchema(z.array(gitHubRepositorySchema)) }
+			}
+		}),
+		checkConfig: defineRoute({
+			method: "POST",
+			path: "/check-config",
+			summary: "Find Intlayer configuration files in a repository",
+			schemas: {
+				body: z.object({
+					...tokenShape,
+					owner: z.string(),
+					repository: z.string(),
+					branch: z.optional(z.string())
+				}),
+				response: { 200: checkConfigResponseSchema }
+			}
+		}),
+		getConfigFile: defineRoute({
+			method: "POST",
+			path: "/get-config-file",
+			summary: "Read an Intlayer configuration file of a repository",
+			schemas: {
+				body: z.object({
+					...tokenShape,
+					...branchAndPathShape,
+					owner: z.string(),
+					repository: z.string()
+				}),
+				response: { 200: configFileResponseSchema }
+			}
+		}),
+		getToken: defineRoute({
+			method: "GET",
+			path: "/token",
+			summary: "GitHub token linked to the signed-in user's account",
+			schemas: { response: { 200: tokenResponseSchema } }
+		})
+	}
+});
+/** REST contract of the `/api/gitlab` routes. */
+const gitlabContract = defineRouteGroup({
+	prefix: "/api/gitlab",
+	tag: "GitLab",
+	routes: {
+		getAuthUrl: defineRoute({
+			method: "GET",
+			path: "/auth-url",
+			summary: "GitLab OAuth authorization URL",
+			schemas: {
+				querystring: z.object({
+					redirectUri: z.string(),
+					/** Self-managed GitLab instance (ex: https://gitlab.company.com). */
+					instanceUrl: z.optional(z.string()),
+					login: z.optional(z.string())
+				}),
+				response: { 200: authUrlResponseSchema }
+			}
+		}),
+		authCallback: defineRoute({
+			method: "POST",
+			path: "/auth",
+			summary: "Exchange the OAuth code for a GitLab token",
+			schemas: {
+				body: z.object({
+					code: z.string(),
+					redirectUri: z.string(),
+					instanceUrl: z.optional(z.string())
+				}),
+				response: { 200: tokenResponseSchema }
+			}
+		}),
+		listProjects: defineRoute({
+			method: "GET",
+			path: "/projects",
+			summary: "Projects of the GitLab account",
+			schemas: {
+				querystring: z.object({
+					...tokenShape,
+					instanceUrl: z.optional(z.string())
+				}),
+				response: { 200: responseDataSchema(z.array(gitLabProjectSchema)) }
+			}
+		}),
+		checkConfig: defineRoute({
+			method: "POST",
+			path: "/check-config",
+			summary: "Find Intlayer configuration files in a project",
+			schemas: {
+				body: z.object({
+					...tokenShape,
+					projectId: z.number(),
+					branch: z.optional(z.string()),
+					instanceUrl: z.optional(z.string())
+				}),
+				response: { 200: checkConfigResponseSchema }
+			}
+		}),
+		getConfigFile: defineRoute({
+			method: "POST",
+			path: "/get-config-file",
+			summary: "Read an Intlayer configuration file of a project",
+			schemas: {
+				body: z.object({
+					...tokenShape,
+					...branchAndPathShape,
+					projectId: z.number(),
+					instanceUrl: z.optional(z.string())
+				}),
+				response: { 200: configFileResponseSchema }
+			}
+		})
+	}
+});
+/** REST contract of the `/api/bitbucket` routes. */
+const bitbucketContract = defineRouteGroup({
+	prefix: "/api/bitbucket",
+	tag: "Bitbucket",
+	routes: {
+		getAuthUrl: defineRoute({
+			method: "GET",
+			path: "/auth-url",
+			summary: "Bitbucket OAuth authorization URL",
+			schemas: {
+				querystring: z.object({ redirectUri: z.string() }),
+				response: { 200: authUrlResponseSchema }
+			}
+		}),
+		authCallback: defineRoute({
+			method: "POST",
+			path: "/auth",
+			summary: "Exchange the OAuth code for a Bitbucket token",
+			schemas: {
+				body: z.object({ code: z.string() }),
+				response: { 200: tokenResponseSchema }
+			}
+		}),
+		listRepos: defineRoute({
+			method: "GET",
+			path: "/repos",
+			summary: "Repositories of the Bitbucket account",
+			schemas: {
+				querystring: z.object(tokenShape),
+				response: { 200: responseDataSchema(z.array(bitbucketRepositorySchema)) }
+			}
+		}),
+		checkConfig: defineRoute({
+			method: "POST",
+			path: "/check-config",
+			summary: "Find Intlayer configuration files in a repository",
+			schemas: {
+				body: z.object({
+					...tokenShape,
+					workspace: z.string(),
+					repoSlug: z.string(),
+					branch: z.optional(z.string())
+				}),
+				response: { 200: checkConfigResponseSchema }
+			}
+		}),
+		getConfigFile: defineRoute({
+			method: "POST",
+			path: "/get-config-file",
+			summary: "Read an Intlayer configuration file of a repository",
+			schemas: {
+				body: z.object({
+					...tokenShape,
+					...branchAndPathShape,
+					workspace: z.string(),
+					repoSlug: z.string()
+				}),
+				response: { 200: configFileResponseSchema }
+			}
+		})
+	}
+});
+
+//#endregion
+export { bitbucketContract, bitbucketRepositorySchema, codebergContract, forgeRepositorySchema, gitHubRepositorySchema, gitLabProjectSchema, giteeContract, githubContract, gitlabContract };
+//# sourceMappingURL=gitProviders.mjs.map

package/dist/esm/gitProviders.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitProviders.mjs","names":[],"sources":["../../src/gitProviders.ts"],"sourcesContent":["import { z } from 'zod/mini';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBodyInput,\n  type RouteQuerystring,\n} from './defineRoute';\nimport { type ResponseData, responseDataSchema } from './responseData';\n\n/**\n * Git provider OAuth + repository routes (repository linking in the\n * dashboard). Each provider gets its own group; the shapes below are shared.\n */\n\nconst authUrlResponseSchema = responseDataSchema(\n  z.object({ authUrl: z.string() })\n);\nconst tokenResponseSchema = responseDataSchema(z.object({ token: z.string() }));\nconst checkConfigResponseSchema = responseDataSchema(\n  z.object({ hasConfig: z.boolean(), configPaths: z.array(z.string()) })\n);\nconst configFileResponseSchema = responseDataSchema(\n  z.object({ content: z.string() })\n);\n\n/** Optional provider token: defaults to the one linked to the user. */\nconst tokenShape = { token: z.optional(z.string()) };\nconst branchAndPathShape = {\n  branch: z.optional(z.string()),\n  path: z.optional(z.string()),\n};\n\n/** GitHub repository (subset of the REST API item the dashboard reads). */\nexport const gitHubRepositorySchema = z.looseObject({\n  id: z.number(),\n  name: z.string(),\n  full_name: z.string(),\n  owner: z.looseObject({\n    login: z.string(),\n    avatar_url: z.optional(z.string()),\n  }),\n  private: z.boolean(),\n  html_url: z.string(),\n  default_branch: z.optional(z.string()),\n  updated_at: z.optional(z.nullable(z.string())),\n});\n\n/** GitLab project (subset the dashboard reads). */\nexport const gitLabProjectSchema = z.looseObject({\n  id: z.number(),\n  name: z.string(),\n  path_with_namespace: z.string(),\n  web_url: z.string(),\n  default_branch: z.string(),\n  visibility: z.string(),\n  last_activity_at: z.string(),\n  namespace: z.looseObject({\n    id: z.number(),\n    name: z.string(),\n    path: z.string(),\n  }),\n});\n\n/** Bitbucket repository (subset the dashboard reads). */\nexport const bitbucketRepositorySchema = z.looseObject({\n  uuid: z.string(),\n  name: z.string(),\n  full_name: z.string(),\n  slug: z.string(),\n  mainbranch: z.optional(z.looseObject({ name: z.string(), type: z.string() })),\n  links: z.looseObject({ html: z.looseObject({ href: z.string() }) }),\n  workspace: z.looseObject({\n    slug: z.string(),\n    name: z.string(),\n    uuid: z.string(),\n  }),\n  is_private: z.optional(z.boolean()),\n  updated_on: z.optional(z.string()),\n});\n\n/**\n * Repository of a Gitea-compatible forge (Codeberg/Forgejo, Gitee), normalized\n * by the backend. `name` is the URL slug used in API paths.\n */\nexport const forgeRepositorySchema = z.object({\n  id: z.number(),\n  name: z.string(),\n  /** Human-readable name (can differ from the slug on Gitee). */\n  displayName: z.string(),\n  full_name: z.string(),\n  owner: z.object({\n    login: z.string(),\n    avatar_url: z.optional(z.string()),\n  }),\n  private: z.boolean(),\n  html_url: z.string(),\n  default_branch: z.optional(z.string()),\n  updated_at: z.optional(z.nullable(z.string())),\n});\n\nconst forgeRepositoryShape = {\n  ...tokenShape,\n  owner: z.string(),\n  repository: z.string(),\n};\n\n/**\n * Builds the contract of a Gitea-compatible forge: repositories are listed and\n * read with the account linked through better-auth.\n */\nconst defineForgeContract = <Prefix extends string, Tag extends string>(\n  prefix: Prefix,\n  tag: Tag\n) =>\n  defineRouteGroup({\n    prefix,\n    tag,\n    routes: {\n      listRepos: defineRoute({\n        method: 'GET',\n        path: '/repos',\n        summary: `Repositories of the ${tag} account`,\n        schemas: {\n          querystring: z.object(tokenShape),\n          response: {\n            200: responseDataSchema(z.array(forgeRepositorySchema)),\n          },\n        },\n      }),\n      checkConfig: defineRoute({\n        method: 'POST',\n        path: '/check-config',\n        summary: 'Find Intlayer configuration files in a repository',\n        schemas: {\n          body: z.object({\n            ...forgeRepositoryShape,\n            branch: z.optional(z.string()),\n          }),\n          response: { 200: checkConfigResponseSchema },\n        },\n      }),\n      getConfigFile: defineRoute({\n        method: 'POST',\n        path: '/get-config-file',\n        summary: 'Read an Intlayer configuration file of a repository',\n        schemas: {\n          body: z.object({ ...forgeRepositoryShape, ...branchAndPathShape }),\n          response: { 200: configFileResponseSchema },\n        },\n      }),\n    },\n  });\n\n/** REST contract of the `/api/codeberg` routes (Codeberg / Forgejo). */\nexport const codebergContract = defineForgeContract(\n  '/api/codeberg',\n  'Codeberg'\n);\n\n/** REST contract of the `/api/gitee` routes. */\nexport const giteeContract = defineForgeContract('/api/gitee', 'Gitee');\n\n/** REST contract of the `/api/github` routes. */\nexport const githubContract = defineRouteGroup({\n  prefix: '/api/github',\n  tag: 'GitHub',\n  routes: {\n    getAuthUrl: defineRoute({\n      method: 'GET',\n      path: '/auth-url',\n      summary: 'GitHub OAuth authorization URL',\n      schemas: {\n        querystring: z.object({\n          redirectUri: z.string(),\n          login: z.optional(z.string()),\n        }),\n        response: { 200: authUrlResponseSchema },\n      },\n    }),\n    authCallback: defineRoute({\n      method: 'POST',\n      path: '/auth',\n      summary: 'Exchange the OAuth code for a GitHub token',\n      schemas: {\n        body: z.object({ code: z.string() }),\n        response: { 200: tokenResponseSchema },\n      },\n    }),\n    listRepos: defineRoute({\n      method: 'GET',\n      path: '/repos',\n      summary: 'Repositories of the GitHub account',\n      schemas: {\n        querystring: z.object(tokenShape),\n        response: {\n          200: responseDataSchema(z.array(gitHubRepositorySchema)),\n        },\n      },\n    }),\n    checkConfig: defineRoute({\n      method: 'POST',\n      path: '/check-config',\n      summary: 'Find Intlayer configuration files in a repository',\n      schemas: {\n        body: z.object({\n          ...tokenShape,\n          owner: z.string(),\n          repository: z.string(),\n          branch: z.optional(z.string()),\n        }),\n        response: { 200: checkConfigResponseSchema },\n      },\n    }),\n    getConfigFile: defineRoute({\n      method: 'POST',\n      path: '/get-config-file',\n      summary: 'Read an Intlayer configuration file of a repository',\n      schemas: {\n        body: z.object({\n          ...tokenShape,\n          ...branchAndPathShape,\n          owner: z.string(),\n          repository: z.string(),\n        }),\n        response: { 200: configFileResponseSchema },\n      },\n    }),\n    getToken: defineRoute({\n      method: 'GET',\n      path: '/token',\n      summary: \"GitHub token linked to the signed-in user's account\",\n      schemas: {\n        response: { 200: tokenResponseSchema },\n      },\n    }),\n  },\n});\n\n/** REST contract of the `/api/gitlab` routes. */\nexport const gitlabContract = defineRouteGroup({\n  prefix: '/api/gitlab',\n  tag: 'GitLab',\n  routes: {\n    getAuthUrl: defineRoute({\n      method: 'GET',\n      path: '/auth-url',\n      summary: 'GitLab OAuth authorization URL',\n      schemas: {\n        querystring: z.object({\n          redirectUri: z.string(),\n          /** Self-managed GitLab instance (ex: https://gitlab.company.com). */\n          instanceUrl: z.optional(z.string()),\n          login: z.optional(z.string()),\n        }),\n        response: { 200: authUrlResponseSchema },\n      },\n    }),\n    authCallback: defineRoute({\n      method: 'POST',\n      path: '/auth',\n      summary: 'Exchange the OAuth code for a GitLab token',\n      schemas: {\n        body: z.object({\n          code: z.string(),\n          redirectUri: z.string(),\n          instanceUrl: z.optional(z.string()),\n        }),\n        response: { 200: tokenResponseSchema },\n      },\n    }),\n    listProjects: defineRoute({\n      method: 'GET',\n      path: '/projects',\n      summary: 'Projects of the GitLab account',\n      schemas: {\n        querystring: z.object({\n          ...tokenShape,\n          instanceUrl: z.optional(z.string()),\n        }),\n        response: { 200: responseDataSchema(z.array(gitLabProjectSchema)) },\n      },\n    }),\n    checkConfig: defineRoute({\n      method: 'POST',\n      path: '/check-config',\n      summary: 'Find Intlayer configuration files in a project',\n      schemas: {\n        body: z.object({\n          ...tokenShape,\n          projectId: z.number(),\n          branch: z.optional(z.string()),\n          instanceUrl: z.optional(z.string()),\n        }),\n        response: { 200: checkConfigResponseSchema },\n      },\n    }),\n    getConfigFile: defineRoute({\n      method: 'POST',\n      path: '/get-config-file',\n      summary: 'Read an Intlayer configuration file of a project',\n      schemas: {\n        body: z.object({\n          ...tokenShape,\n          ...branchAndPathShape,\n          projectId: z.number(),\n          instanceUrl: z.optional(z.string()),\n        }),\n        response: { 200: configFileResponseSchema },\n      },\n    }),\n  },\n});\n\n/** REST contract of the `/api/bitbucket` routes. */\nexport const bitbucketContract = defineRouteGroup({\n  prefix: '/api/bitbucket',\n  tag: 'Bitbucket',\n  routes: {\n    getAuthUrl: defineRoute({\n      method: 'GET',\n      path: '/auth-url',\n      summary: 'Bitbucket OAuth authorization URL',\n      schemas: {\n        querystring: z.object({ redirectUri: z.string() }),\n        response: { 200: authUrlResponseSchema },\n      },\n    }),\n    authCallback: defineRoute({\n      method: 'POST',\n      path: '/auth',\n      summary: 'Exchange the OAuth code for a Bitbucket token',\n      schemas: {\n        body: z.object({ code: z.string() }),\n        response: { 200: tokenResponseSchema },\n      },\n    }),\n    listRepos: defineRoute({\n      method: 'GET',\n      path: '/repos',\n      summary: 'Repositories of the Bitbucket account',\n      schemas: {\n        querystring: z.object(tokenShape),\n        response: {\n          200: responseDataSchema(z.array(bitbucketRepositorySchema)),\n        },\n      },\n    }),\n    checkConfig: defineRoute({\n      method: 'POST',\n      path: '/check-config',\n      summary: 'Find Intlayer configuration files in a repository',\n      schemas: {\n        body: z.object({\n          ...tokenShape,\n          workspace: z.string(),\n          repoSlug: z.string(),\n          branch: z.optional(z.string()),\n        }),\n        response: { 200: checkConfigResponseSchema },\n      },\n    }),\n    getConfigFile: defineRoute({\n      method: 'POST',\n      path: '/get-config-file',\n      summary: 'Read an Intlayer configuration file of a repository',\n      schemas: {\n        body: z.object({\n          ...tokenShape,\n          ...branchAndPathShape,\n          workspace: z.string(),\n          repoSlug: z.string(),\n        }),\n        response: { 200: configFileResponseSchema },\n      },\n    }),\n  },\n});\n\nexport type GitHubRoutes = (typeof githubContract)['routes'];\nexport type GitLabRoutes = (typeof gitlabContract)['routes'];\nexport type BitbucketRoutes = (typeof bitbucketContract)['routes'];\n/** Routes shared by every Gitea-compatible forge (Codeberg, Gitee). */\nexport type ForgeRoutes = (typeof codebergContract)['routes'];\nexport type CodebergRoutes = ForgeRoutes;\nexport type GiteeRoutes = (typeof giteeContract)['routes'];\n\ntype AuthUrlResult = ResponseData<{ authUrl: string }>;\ntype TokenResult = ResponseData<{ token: string }>;\ntype CheckConfigResult = ResponseData<{\n  hasConfig: boolean;\n  configPaths: string[];\n}>;\ntype ConfigFileResult = ResponseData<{ content: string }>;\n\nexport type GitHubRepository = z.output<typeof gitHubRepositorySchema>;\nexport type GitLabProject = z.output<typeof gitLabProjectSchema>;\nexport type BitbucketRepository = z.output<typeof bitbucketRepositorySchema>;\nexport type ForgeRepository = z.output<typeof forgeRepositorySchema>;\n\nexport type GitHubGetAuthUrlQuerystring = RouteQuerystring<\n  GitHubRoutes['getAuthUrl']\n>;\nexport type GitHubGetAuthUrlResult = AuthUrlResult;\nexport type GitHubAuthCallbackBody = RouteBodyInput<\n  GitHubRoutes['authCallback']\n>;\nexport type GitHubAuthCallbackResult = TokenResult;\nexport type GitHubListReposQuerystring = RouteQuerystring<\n  GitHubRoutes['listRepos']\n>;\nexport type GitHubListReposResult = ResponseData<GitHubRepository[]>;\nexport type GitHubCheckConfigBody = RouteBodyInput<GitHubRoutes['checkConfig']>;\nexport type GitHubCheckConfigResult = CheckConfigResult;\nexport type GitHubGetConfigFileBody = RouteBodyInput<\n  GitHubRoutes['getConfigFile']\n>;\nexport type GitHubGetConfigFileResult = ConfigFileResult;\nexport type GitHubGetTokenResult = TokenResult;\n\nexport type GitLabGetAuthUrlQuerystring = RouteQuerystring<\n  GitLabRoutes['getAuthUrl']\n>;\nexport type GitLabGetAuthUrlResult = AuthUrlResult;\nexport type GitLabAuthCallbackBody = RouteBodyInput<\n  GitLabRoutes['authCallback']\n>;\nexport type GitLabAuthCallbackResult = TokenResult;\nexport type GitLabListProjectsQuerystring = RouteQuerystring<\n  GitLabRoutes['listProjects']\n>;\nexport type GitLabListProjectsResult = ResponseData<GitLabProject[]>;\nexport type GitLabCheckConfigBody = RouteBodyInput<GitLabRoutes['checkConfig']>;\nexport type GitLabCheckConfigResult = CheckConfigResult;\nexport type GitLabGetConfigFileBody = RouteBodyInput<\n  GitLabRoutes['getConfigFile']\n>;\nexport type GitLabGetConfigFileResult = ConfigFileResult;\n\nexport type BitbucketGetAuthUrlQuerystring = RouteQuerystring<\n  BitbucketRoutes['getAuthUrl']\n>;\nexport type BitbucketGetAuthUrlResult = AuthUrlResult;\nexport type BitbucketAuthCallbackBody = RouteBodyInput<\n  BitbucketRoutes['authCallback']\n>;\nexport type BitbucketAuthCallbackResult = TokenResult;\nexport type BitbucketListReposQuerystring = RouteQuerystring<\n  BitbucketRoutes['listRepos']\n>;\nexport type BitbucketListReposResult = ResponseData<BitbucketRepository[]>;\nexport type BitbucketCheckConfigBody = RouteBodyInput<\n  BitbucketRoutes['checkConfig']\n>;\nexport type BitbucketCheckConfigResult = CheckConfigResult;\nexport type BitbucketGetConfigFileBody = RouteBodyInput<\n  BitbucketRoutes['getConfigFile']\n>;\nexport type BitbucketGetConfigFileResult = ConfigFileResult;\n\nexport type ForgeListReposQuerystring = RouteQuerystring<\n  ForgeRoutes['listRepos']\n>;\nexport type ForgeListReposResult = ResponseData<ForgeRepository[]>;\nexport type ForgeCheckConfigBody = RouteBodyInput<ForgeRoutes['checkConfig']>;\nexport type ForgeCheckConfigResult = CheckConfigResult;\nexport type ForgeGetConfigFileBody = RouteBodyInput<\n  ForgeRoutes['getConfigFile']\n>;\nexport type ForgeGetConfigFileResult = ConfigFileResult;\n"],"mappings":"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"}

package/dist/esm/newsletter.mjs

@@ -0,0 +1,49 @@
+import { defineRoute, defineRouteGroup } from "./defineRoute.mjs";
+import { responseDataSchema } from "./responseData.mjs";
+import { emailsListSchema, userSchema } from "./user.mjs";
+import { z } from "zod/mini";
+
+//#region src/newsletter.ts
+/** One mailing list or several. */
+const emailListSchema = z.union([emailsListSchema, z.array(emailsListSchema)]);
+/** REST contract of the `/api/newsletter` routes. */
+const newsletterContract = defineRouteGroup({
+	prefix: "/api/newsletter",
+	tag: "Newsletter",
+	routes: {
+		subscribeToNewsletter: defineRoute({
+			method: "POST",
+			path: "/subscribe",
+			summary: "Subscribe an email to mailing lists",
+			schemas: {
+				body: z.object({
+					email: z.string().check(z.minLength(1)),
+					emailList: emailListSchema
+				}),
+				response: { 200: responseDataSchema(userSchema) }
+			}
+		}),
+		unsubscribeFromNewsletter: defineRoute({
+			method: "POST",
+			path: "/unsubscribe",
+			summary: "Unsubscribe a user from mailing lists",
+			schemas: {
+				body: z.object({
+					userId: z.string(),
+					emailList: emailListSchema
+				}),
+				response: { 200: responseDataSchema(userSchema) }
+			}
+		}),
+		getNewsletterStatus: defineRoute({
+			method: "GET",
+			path: "/status",
+			summary: "Mailing list subscriptions of the signed-in user",
+			schemas: { response: { 200: responseDataSchema(userSchema) } }
+		})
+	}
+});
+
+//#endregion
+export { newsletterContract };
+//# sourceMappingURL=newsletter.mjs.map

package/dist/esm/newsletter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter.mjs","names":[],"sources":["../../src/newsletter.ts"],"sourcesContent":["import { z } from 'zod/mini';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBodyInput,\n} from './defineRoute';\nimport { type ResponseData, responseDataSchema } from './responseData';\nimport { emailsListSchema, type UserAPI, userSchema } from './user';\n\n/** One mailing list or several. */\nconst emailListSchema = z.union([emailsListSchema, z.array(emailsListSchema)]);\n\n/** REST contract of the `/api/newsletter` routes. */\nexport const newsletterContract = defineRouteGroup({\n  prefix: '/api/newsletter',\n  tag: 'Newsletter',\n  routes: {\n    subscribeToNewsletter: defineRoute({\n      method: 'POST',\n      path: '/subscribe',\n      summary: 'Subscribe an email to mailing lists',\n      schemas: {\n        body: z.object({\n          email: z.string().check(z.minLength(1)),\n          emailList: emailListSchema,\n        }),\n        response: { 200: responseDataSchema(userSchema) },\n      },\n    }),\n    unsubscribeFromNewsletter: defineRoute({\n      method: 'POST',\n      path: '/unsubscribe',\n      summary: 'Unsubscribe a user from mailing lists',\n      schemas: {\n        body: z.object({\n          userId: z.string(),\n          emailList: emailListSchema,\n        }),\n        response: { 200: responseDataSchema(userSchema) },\n      },\n    }),\n    getNewsletterStatus: defineRoute({\n      method: 'GET',\n      path: '/status',\n      summary: 'Mailing list subscriptions of the signed-in user',\n      schemas: {\n        response: { 200: responseDataSchema(userSchema) },\n      },\n    }),\n  },\n});\n\n/** Route definitions of the `/api/newsletter` group, by name. */\nexport type NewsletterRoutes = (typeof newsletterContract)['routes'];\n\nexport type NewsletterSubscriptionBody = RouteBodyInput<\n  NewsletterRoutes['subscribeToNewsletter']\n>;\nexport type NewsletterSubscriptionResult = ResponseData<UserAPI>;\nexport type NewsletterUnsubscriptionBody = RouteBodyInput<\n  NewsletterRoutes['unsubscribeFromNewsletter']\n>;\nexport type NewsletterUnsubscriptionResult = ResponseData<UserAPI>;\nexport type GetNewsletterStatusResult = ResponseData<UserAPI>;\n"],"mappings":";;;;;;;AAUA,MAAM,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,gBAAgB,CAAC,CAAC;;AAG7E,MAAa,qBAAqB,iBAAiB;CACjD,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,uBAAuB,YAAY;GACjC,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;IACP,MAAM,EAAE,OAAO;KACb,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KACtC,WAAW;IACb,CAAC;IACD,UAAU,EAAE,KAAK,mBAAmB,UAAU,EAAE;GAClD;EACF,CAAC;EACD,2BAA2B,YAAY;GACrC,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;IACP,MAAM,EAAE,OAAO;KACb,QAAQ,EAAE,OAAO;KACjB,WAAW;IACb,CAAC;IACD,UAAU,EAAE,KAAK,mBAAmB,UAAU,EAAE;GAClD;EACF,CAAC;EACD,qBAAqB,YAAY;GAC/B,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS,EACP,UAAU,EAAE,KAAK,mBAAmB,UAAU,EAAE,EAClD;EACF,CAAC;CACH;AACF,CAAC"}

package/dist/esm/oAuth2.mjs

@@ -0,0 +1,60 @@
+import { defineRoute, defineRouteGroup } from "./defineRoute.mjs";
+import { responseDataSchema } from "./responseData.mjs";
+import { dateTimeSchema } from "./common.mjs";
+import { userSchema } from "./user.mjs";
+import { projectSchema } from "./project.mjs";
+import { organizationSchema } from "./organization.mjs";
+import { z } from "zod/mini";
+
+//#region src/oAuth2.ts
+/** Access token issued for an access key (client credentials). */
+const oAuth2TokenSchema = z.looseObject({
+	accessToken: z.string(),
+	/** `null` for a token without expiry. */
+	accessTokenExpiresAt: z.optional(z.nullable(dateTimeSchema)),
+	grants: z.optional(z.array(z.string())),
+	client: z.looseObject({
+		id: z.string(),
+		grants: z.array(z.string())
+	}),
+	user: userSchema,
+	organization: organizationSchema,
+	project: projectSchema
+});
+/** REST contract of the OAuth2 client-credentials routes. */
+const oAuth2Contract = defineRouteGroup({
+	prefix: "/oauth2",
+	tag: "OAuth2",
+	routes: {
+		getOAuth2AccessToken: defineRoute({
+			method: "POST",
+			path: "/token",
+			summary: "Exchange access key credentials for an access token",
+			schemas: {
+				/**
+				* Documented only: the OAuth2 server validates it (credentials may
+				* also come from a Basic auth header) and answers spec errors.
+				*/
+				body: z.looseObject({
+					grant_type: z.optional(z.string()),
+					client_id: z.optional(z.string()),
+					client_secret: z.optional(z.string())
+				}),
+				response: { 200: responseDataSchema(oAuth2TokenSchema) }
+			}
+		}),
+		extendOAuth2Token: defineRoute({
+			method: "POST",
+			path: "/token/extend",
+			summary: "Extend the lifetime of the current access token",
+			schemas: { response: { 200: responseDataSchema(z.object({
+				accessToken: z.string(),
+				accessTokenExpiresAt: dateTimeSchema
+			})) } }
+		})
+	}
+});
+
+//#endregion
+export { oAuth2Contract, oAuth2TokenSchema };
+//# sourceMappingURL=oAuth2.mjs.map

package/dist/esm/oAuth2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"oAuth2.mjs","names":[],"sources":["../../src/oAuth2.ts"],"sourcesContent":["import { z } from 'zod/mini';\nimport { dateTimeSchema } from './common';\nimport {\n  defineRoute,\n  defineRouteGroup,\n  type RouteBodyInput,\n} from './defineRoute';\nimport { organizationSchema } from './organization';\nimport { projectSchema } from './project';\nimport { type ResponseData, responseDataSchema } from './responseData';\nimport { userSchema } from './user';\n\n/** Access token issued for an access key (client credentials). */\nexport const oAuth2TokenSchema = z.looseObject({\n  accessToken: z.string(),\n  /** `null` for a token without expiry. */\n  accessTokenExpiresAt: z.optional(z.nullable(dateTimeSchema)),\n  grants: z.optional(z.array(z.string())),\n  client: z.looseObject({ id: z.string(), grants: z.array(z.string()) }),\n  user: userSchema,\n  organization: organizationSchema,\n  project: projectSchema,\n});\n\n/** REST contract of the OAuth2 client-credentials routes. */\nexport const oAuth2Contract = defineRouteGroup({\n  prefix: '/oauth2',\n  tag: 'OAuth2',\n  routes: {\n    getOAuth2AccessToken: defineRoute({\n      method: 'POST',\n      path: '/token',\n      summary: 'Exchange access key credentials for an access token',\n      schemas: {\n        /**\n         * Documented only: the OAuth2 server validates it (credentials may\n         * also come from a Basic auth header) and answers spec errors.\n         */\n        body: z.looseObject({\n          grant_type: z.optional(z.string()),\n          client_id: z.optional(z.string()),\n          client_secret: z.optional(z.string()),\n        }),\n        response: { 200: responseDataSchema(oAuth2TokenSchema) },\n      },\n    }),\n    extendOAuth2Token: defineRoute({\n      method: 'POST',\n      path: '/token/extend',\n      summary: 'Extend the lifetime of the current access token',\n      schemas: {\n        response: {\n          200: responseDataSchema(\n            z.object({\n              accessToken: z.string(),\n              accessTokenExpiresAt: dateTimeSchema,\n            })\n          ),\n        },\n      },\n    }),\n  },\n});\n\n/** Route definitions of the OAuth2 group, by name. */\nexport type OAuth2Routes = (typeof oAuth2Contract)['routes'];\n\nexport type OAuth2Token = z.output<typeof oAuth2TokenSchema>;\nexport type GetOAuth2TokenBody = RouteBodyInput<\n  OAuth2Routes['getOAuth2AccessToken']\n>;\nexport type GetOAuth2TokenResult = ResponseData<OAuth2Token>;\nexport type ExtendOAuth2TokenResult = ResponseData<{\n  accessToken: string;\n  accessTokenExpiresAt: string;\n}>;\n"],"mappings":";;;;;;;;;;AAaA,MAAa,oBAAoB,EAAE,YAAY;CAC7C,aAAa,EAAE,OAAO;;CAEtB,sBAAsB,EAAE,SAAS,EAAE,SAAS,cAAc,CAAC;CAC3D,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,QAAQ,EAAE,YAAY;EAAE,IAAI,EAAE,OAAO;EAAG,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;CAAE,CAAC;CACrE,MAAM;CACN,cAAc;CACd,SAAS;AACX,CAAC;;AAGD,MAAa,iBAAiB,iBAAiB;CAC7C,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,sBAAsB,YAAY;GAChC,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS;;;;;IAKP,MAAM,EAAE,YAAY;KAClB,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC;KACjC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;KAChC,eAAe,EAAE,SAAS,EAAE,OAAO,CAAC;IACtC,CAAC;IACD,UAAU,EAAE,KAAK,mBAAmB,iBAAiB,EAAE;GACzD;EACF,CAAC;EACD,mBAAmB,YAAY;GAC7B,QAAQ;GACR,MAAM;GACN,SAAS;GACT,SAAS,EACP,UAAU,EACR,KAAK,mBACH,EAAE,OAAO;IACP,aAAa,EAAE,OAAO;IACtB,sBAAsB;GACxB,CAAC,CACH,EACF,EACF;EACF,CAAC;CACH;AACF,CAAC"}