@mapcreator/api 0.0.0-fonts.0

package/esm/utils.js

@@ -0,0 +1,206 @@
+import { apiHost, authenticate, token } from './oauth.js';
+export const myUser = 'me';
+export const myOrganisations = 'mine';
+export const lastJobRevision = 'last';
+export const defaultListHeader = { 'X-Per-Page': '50' };
+export const deletedNoneParam = getSearchParams({ deleted: 'none' });
+export const keysToRemove = ['created_at', 'deleted_at', 'updated_at'];
+export const staticContext = { keysToRemove: new Set(keysToRemove), keysToAdd: [], revivers: {} };
+// class AuthorizationError extends Error {}
+export class NetworkError extends Error {
+}
+export class HTTPError extends Error {
+    constructor(response) {
+        super(response.statusText);
+        this.statusCode = response.status;
+    }
+}
+export class APIError extends Error {
+    constructor(apiError) {
+        super(apiError.error.message);
+        this.code = apiError.error.type;
+    }
+}
+export function getSearchParams(search) {
+    return new URLSearchParams(Object.entries(search).reduce((arr, [key, value]) => {
+        if (Array.isArray(value)) {
+            arr.push(...value.map(val => [`${key}[]`, String(val)]));
+        }
+        else if (value !== null && typeof value === 'object') {
+            const params = getSearchParams(value);
+            arr.push(...Array.from(params.entries()).map(([subKey, val]) => [
+                ~subKey.indexOf('[')
+                    ? `${key}[${subKey.slice(0, subKey.indexOf('['))}]${subKey.slice(subKey.indexOf('['))}`
+                    : `${key}[${subKey}]`,
+                val,
+            ]));
+        }
+        else {
+            arr.push([key, String(value)]);
+        }
+        return arr;
+    }, []));
+}
+export class APIMeta extends Error {
+    constructor(data, headers, status) {
+        super();
+        this.data = data;
+        this.status = status;
+        this.headers = headers;
+    }
+}
+export async function request(path, body, extraHeaders, extraOptions) {
+    const href = `${apiHost}${path}`;
+    const init = getRequestInit(body, extraHeaders, extraOptions);
+    const response = await fetch(href, init).catch((error) => {
+        var _a;
+        throw new NetworkError((_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error);
+    });
+    if (response.ok) {
+        const json = (await response.json().catch(() => ({
+            success: false,
+            error: { type: 'SyntaxError', message: 'Malformed JSON response' },
+        })));
+        if (json.success) {
+            const { data } = json;
+            const withMeta = extraOptions === null || extraOptions === void 0 ? void 0 : extraOptions.withMeta;
+            const revivers = extraOptions === null || extraOptions === void 0 ? void 0 : extraOptions.revivers;
+            const keys = revivers ? Object.keys(revivers) : [];
+            const context = revivers && keys.length
+                ? getContext(revivers, keys)
+                : staticContext;
+            let result;
+            if (Array.isArray(data)) {
+                let moreData = [];
+                const headers = response.headers;
+                // @ts-expect-error TS2362, get valid number or 0
+                const total = headers.get('X-Paginate-Total') | 0;
+                if (!withMeta && ((data.length && total > data.length) || response.status === 206)) {
+                    // @ts-expect-error TS2362, get valid number or 0
+                    const offset = `${(headers.get('X-Paginate-Offset') | 0) + data.length}`;
+                    moreData = await request(path, body, Object.assign(Object.assign({}, extraHeaders), { 'X-Offset': offset }), extraOptions);
+                }
+                if (data.length) {
+                    result = (typeof data[0] !== 'string'
+                        ? data.map(processData, context)
+                        : data).concat(moreData);
+                }
+                else {
+                    result = moreData;
+                }
+            }
+            else {
+                if (data !== undefined) {
+                    // @ts-expect-error TS2345, TODO: fix type error for the `context` object
+                    result = (typeof data !== 'string' ? processData.call(context, data) : data);
+                }
+                else {
+                    result = {};
+                }
+            }
+            if (withMeta) {
+                throw new APIMeta(result, response.headers, response.status);
+            }
+            return result;
+        }
+        else {
+            throw new APIError(json);
+        }
+    }
+    else {
+        // TODO: parse and process all typical errors
+        // eslint-disable-next-line default-case
+        switch (response.status) {
+            case 401:
+                await authenticate();
+                break; // NO-OP
+            case 403:
+            case 404:
+            case 406:
+                throw new APIError((await response.json().catch(() => ({
+                    success: false,
+                    error: { type: 'HttpException', message: response.statusText },
+                }))));
+            case 429:
+                await new Promise((resolve) => { setTimeout(resolve, response.headers.get('X-RateLimit-Reset') * 1000 || 500); });
+                return request(path, body, extraHeaders, extraOptions);
+        }
+        throw new HTTPError(response);
+    }
+}
+function getRequestInit(body, extraHeaders, extraOptions) {
+    var _a;
+    const authorization = token ? { Authorization: token.toString() } : null;
+    let contentType = null;
+    if (body !== undefined) {
+        switch (true) {
+            case typeof body === 'string':
+                contentType = { 'Content-Type': 'text/plain' };
+                break;
+            case body instanceof FormData: // Autofilled with 'multipart/form-data'
+            case body instanceof URLSearchParams: // Autofilled with 'application/x-www-form-urlencoded'
+                break;
+            case body instanceof Blob: // File is instance of Blob too
+                contentType = { 'Content-Type': body.type || 'application/octet-stream' };
+                break;
+            case body instanceof ArrayBuffer:
+            case ArrayBuffer.isView(body):
+                contentType = { 'Content-Type': 'application/octet-stream' };
+                break;
+            case body === null && !(extraOptions === null || extraOptions === void 0 ? void 0 : extraOptions.sendNull):
+                break;
+            default:
+                contentType = { 'Content-Type': 'application/json' };
+                body = JSON.stringify(body);
+        }
+    }
+    const headers = Object.assign(Object.assign(Object.assign({ Accept: 'application/json' }, authorization), contentType), extraHeaders);
+    const method = (_a = extraOptions === null || extraOptions === void 0 ? void 0 : extraOptions.method) !== null && _a !== void 0 ? _a : (body != null ? 'POST' : 'GET'); // don't touch `!=` please
+    return { body, headers, method };
+}
+export function getContext(revivers, keys = Object.keys(revivers)) {
+    return {
+        keysToRemove: new Set(keys.filter(isUndefined, revivers).concat(keysToRemove)),
+        keysToAdd: keys.filter(isReviver, revivers),
+        revivers,
+    };
+}
+export function processData(data) {
+    const result = {};
+    const keys = Object.keys(data).filter(isPreserved, this.keysToRemove);
+    for (let i = 0; i < keys.length; ++i) {
+        result[toCamelCase(keys[i])] = data[keys[i]];
+    }
+    if (this.keysToAdd.length) {
+        const keys = this.keysToAdd;
+        for (let i = 0; i < keys.length; ++i) {
+            result[keys[i]] = this.revivers[keys[i]](data);
+        }
+    }
+    return result;
+} /* eslint-enable @typescript-eslint/prefer-for-of */
+export function toApiType(body) {
+    return Object.fromEntries(Object.entries(body).map(([k, v]) => [toSnakeCase(k), v]));
+}
+export function toAppType(body) {
+    return Object.fromEntries(Object.entries(body).map(([k, v]) => [toCamelCase(k), v]));
+}
+export function ensureArray(data) {
+    return Array.isArray(data) ? data : [data];
+}
+function toCamelCase(key) {
+    return key.replace(/_+(.)/g, (_, c) => c.toUpperCase());
+}
+function toSnakeCase(key) {
+    return key.replace(/[A-Z]/g, '_$&').toLowerCase();
+}
+function isUndefined(key) {
+    return this[key] === undefined;
+}
+function isReviver(key) {
+    return this[key] !== undefined;
+}
+function isPreserved(key) {
+    return !this.has(key);
+}
+//# sourceMappingURL=utils.js.map

package/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@mapcreator/api",
+  "version": "0.0.0-fonts.0",
+  "description": "Mapcreator JavaScript API",
+  "license": "BSD-3-Clause",
+  "main": "./cjs/index.js",
+  "types": "./cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./esm/index.d.ts",
+      "import": "./esm/index.js",
+      "require": "./cjs/index.js"
+    },
+    "./oauth": {
+      "types": "./esm/oauth.d.ts",
+      "import": "./esm/oauth.js",
+      "require": "./cjs/oauth.js"
+    },
+    "./oauth.js": {
+      "types": "./esm/oauth.d.ts",
+      "import": "./esm/oauth.js",
+      "require": "./cjs/oauth.js"
+    },
+    "./utils": {
+      "types": "./esm/utils.d.ts",
+      "import": "./esm/utils.js",
+      "require": "./cjs/utils.js"
+    },
+    "./utils.js": {
+      "types": "./esm/utils.d.ts",
+      "import": "./esm/utils.js",
+      "require": "./cjs/utils.js"
+    },
+    "./package.json": "./package.json",
+    "./*": {
+      "types": "./esm/api/*.d.ts",
+      "import": "./esm/api/*.js",
+      "require": "./cjs/api/*.js"
+    },
+    "./*.js": {
+      "types": "./esm/api/*.d.ts",
+      "import": "./esm/api/*.js",
+      "require": "./cjs/api/*.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --outDir esm && tsc -m commonjs --outDir cjs",
+    "clean": "npx rimraf esm/ cjs/",
+    "lint": "eslint --ext .ts src",
+    "prepublishOnly": "npm run lint && npm run clean && npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/mapcreator/api-wrapper.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "cjs",
+    "esm",
+    "src"
+  ],
+  "bugs": {
+    "url": "https://gitlab.com/mapcreator/api-wrapper/issues"
+  },
+  "homepage": "https://gitlab.com/mapcreator/api-wrapper#readme",
+  "dependencies": {
+    "@types/geojson": "^7946.0.14",
+    "type-fest": "^4.10"
+  },
+  "devDependencies": {
+    "@stylistic/eslint-plugin": "~1.5",
+    "@typescript-eslint/eslint-plugin": "~6.15",
+    "@typescript-eslint/parser": "~6.15",
+    "eslint": "~8.57",
+    "typescript": "~5.8.3"
+  }
+}

package/src/README.md

@@ -0,0 +1,126 @@
+### Used type system
+
+We use type declarations for both the data coming over the wire and the data used by the application. In general, these types differ only in the presence of additional fields in the data arriving over the network (like `created_at`), and used naming convention. Data over the network uses the so-called snake case.
+
+All in all, we can use TypeScript's native mechanisms to convert one type to another and fully define just one type:
+
+```typescript
+import type { CamelCasedProperties } from 'type-fest';
+
+type ApiType =
+  | ({
+      data: {
+        prop: unknown;
+      } & ApiCommonData;
+    } & Omit<ApiSuccess, 'data'>)
+  | ApiError;
+
+type AppType = CamelCasedProperties<Omit<Exclude<ApiType, ApiError>['data'], keyof ApiCommonData>>;
+```
+
+or in reverse order:
+
+```typescript
+import type { SnakeCasedProperties } from 'type-fest';
+
+type AppType = {
+  prop: unknown;
+};
+
+type ApiType =
+  | ({
+      data: SnakeCasedProperties<AppType> & ApiCommonData;
+    } & Omit<ApiSuccess, 'data'>)
+  | ApiError;
+```
+
+But the decision was made not to do this, since it may be more difficult for the developer to make the conversion in their head than to see it in front of their eyes.
+
+### Using a `request()`
+
+The function has the following signature:
+
+```typescript
+async function request<I extends ApiCommon, O extends Record<string, unknown> | string>(
+  path: string,
+  body?: XMLHttpRequestBodyInit | Record<string | number, unknown> | null,
+  extraHeaders?: Record<string, string> | null,
+  extraOptions?: ExtraOptions<I, O>,
+): Promise<O | O[]> { /* ... */ }
+```
+
+Let's take it step by step.
+
+`I extends ApiCommon` - represents the type of data we receive over the network.
+
+`O extends Record<string, unknown> | string` - represents the data type that will be used in the application.
+
+Ideally you should describe and convey both types. This will help to check the data types in the arguments passed.
+See current data types for an example.
+
+`path: string` - the path to the resource, must include the API version, but must not include the schema or authority.
+Example: `/v1/jobs/12345`
+
+`body?: XMLHttpRequestBodyInit | Record<string | number, unknown> | null` - any meaningful body type. In general,
+the presence of an JSON object is assumed (or the absence of one for methods that only request data), but you can
+also pass `Blob`, `FormData`, `URLSearchParams` or just `ArrayBuffer`. The required content type will be added to
+the headers automatically.
+
+`extraHeaders?: Record<string, string> | null` - the object with additional headers.
+
+`extraOptions?: ExtraOptions<I, O>` - where `ExtraOptions<I, O>` is defined like this:
+
+```typescript
+interface ExtraOptions<I extends ApiCommon, O extends Record<string, unknown> | string> {
+  method?: 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  revivers?: O extends Record<string, unknown> ? Revivers<I, O> : never;
+  sendNull?: boolean;
+  withMeta?: boolean;
+}
+```
+
+Most fields are self-explanatory.
+
+`sendNull` can be used if you really want to pass `null` as body content.
+
+`revivers` is used to specify an object that can modify the behavior of the internal handler of data coming over
+the network. Let's take a closer look at this moment.
+
+#### Revivers
+
+By default, the `request()` function does the following things with data coming over the network:
+
+- It removes `created_at`, `updated_at`, `deleted_at` fields from the output objects.
+- It preserves all the remaining fields but converts their names into camelCase.
+
+When passing an object with revivers you can a couple of things:
+
+- You can list the fields that you want **to exclude** from the result object. To do this, the field must be assigned an
+`undefined` value.
+- You can **add** new fields or **modify** the type of existing ones. To do this, you need to pass a function as a field
+value, which will receive the original object as input.
+
+Example:
+
+```typescript
+const jobRevivers: Revivers<ApiJob, Job> = {
+  user_id: undefined,
+  description: undefined,
+  share_token: undefined,
+  autosave_preview_path: undefined,
+  job_folder_id: undefined,
+
+  jobTypeId: () => 9,
+  createdAt: (data: ApiJobData) => data.created_at as string,
+  previewPath: (data: ApiJobData) => data.autosave_preview_path ?? undefined,
+};
+```
+
+`user_id`, `description`, `share_token`, `autosave_preview_path`, `job_folder_id` fields will be excluded from the
+result object.
+
+`jobTypeId` will be always **9**.
+
+`createdAt` will be returned (please note that that field is excluded by default)
+
+`previewPath` - some actions will be performed with the source data.

package/src/api/apiCommon.ts

@@ -0,0 +1,70 @@
+import { type ApiJobData, type Job, jobRevivers } from './job.js';
+import {
+  APIMeta,
+  type ApiError,
+  type ApiSuccess,
+  type Revivers,
+  defaultListHeader,
+  getSearchParams,
+  request,
+} from '../utils.js';
+
+export interface JobSearchResult {
+  pageCount: number;
+  data: Job[];
+}
+
+export async function listJobs(
+  pathname: string,
+  title: string,
+  page: number,
+  searchOptions?: Record<string, unknown>,
+): Promise<JobSearchResult> {
+  const defaultSearchOptions = {
+    sort: '-updated',
+    only_downloaded: false,
+  };
+
+  const search = { ...defaultSearchOptions, ...searchOptions };
+
+  const query = getSearchParams({
+    only_with_revisions: true,
+    search: {
+      job_type_id: '9',
+      ...(title.length > 0 && { title: `~:${title}` }),
+    },
+    ...search,
+  });
+
+  const path = `${pathname}?${query}`;
+
+  const headers = {
+    ...defaultListHeader,
+    'X-Page': `${page}`,
+  };
+  const options = {
+    revivers: jobRevivers as Revivers<ApiJobArray, Job>,
+    withMeta: true,
+  };
+
+  type ApiJobArray = {
+    data: ApiJobData[];
+  } & Omit<ApiSuccess, 'data'> | ApiError;
+
+  const result = (await request<ApiJobArray, Job>(path, null, headers, options).catch(
+    (error: Error) => {
+      if (error instanceof APIMeta) {
+        const { data, headers, status } = error as APIMeta<ApiJobArray, Job>;
+
+        return { data, headers, status };
+      }
+
+      throw error;
+    },
+  )) as APIMeta<ApiJobArray, Job>;
+
+  return {
+    data: result.data,
+    pageCount: Number(result.headers.get('X-Paginate-Pages')),
+  };
+}

package/src/api/choropleth.ts

@@ -0,0 +1,132 @@
+import { type ApiError, type ApiSuccess, Flatten, Revivers, getSearchParams, request } from '../utils.js';
+import type { Polygon } from 'geojson';
+import { RequireAtLeastOne } from 'type-fest';
+
+export type ApiSearchPoint = {
+  lat: number;
+  lng: number;
+};
+
+export type ApiSearchBounds = {
+  min_lat: number;
+  min_lng: number;
+  max_lat: number;
+  max_lng: number;
+};
+
+type ApiSingleOrGroupedArea = {
+  id: number;
+  title: string;
+  subtitle: string;
+  svg_preview: string;
+  bounding_box: string;
+  is_group: boolean;
+  vector_source: string | null;
+  source_layer: string | null;
+  feature_id: number | null;
+  properties: Record<string, string> | null;
+};
+
+type ApiSingleOrGroupedAreaArray = {
+  data: ApiSingleOrGroupedArea[];
+} & Omit<ApiSuccess, 'data'> | ApiError;
+
+type SingleOrGroupedAreaBase = {
+  id: number;
+  title: string;
+  subtitle: string;
+  svgPreview: string;
+  boundingBox: Polygon;
+};
+
+// TODO don't export this once search on click is out
+export type GroupedArea = SingleOrGroupedAreaBase & {
+  isGroup: true;
+};
+
+// TODO don't export this once search on click is out
+export type SingleArea = SingleOrGroupedAreaBase & {
+  isGroup: false;
+  vectorSource: string;
+  sourceLayer: string;
+  featureId: number;
+  properties: Record<string, string>;
+};
+
+export type SingleOrGroupedArea = SingleArea | GroupedArea;
+
+export async function searchSingleOrGroupedAreas(
+  language: string,
+  search: RequireAtLeastOne<{
+    searchBounds?: ApiSearchBounds;
+    query?: string;
+    searchPoint?: ApiSearchPoint;
+  }>,
+  mode: 'polygon' | 'group' | 'both' = 'both',
+): Promise<SingleOrGroupedArea[]> {
+  /**
+   * TODO When SAGA search on click is implemented, remove mode and make searchBounds required
+   */
+  return request<ApiSingleOrGroupedAreaArray, SingleOrGroupedArea>(
+    `/v1/choropleth/polygons/search?${getSearchParams({
+      language,
+      ...search.searchBounds,
+      ...(search.query && { query: search.query }),
+      ...(search.searchPoint && { point: search.searchPoint }),
+      mode,
+    })}`,
+  ).then(result => {
+    result.forEach(
+      elem => {
+        elem.boundingBox = JSON.parse(elem.boundingBox as unknown as string) as Polygon;
+        if (!elem.isGroup) {
+          elem.properties = JSON.parse(elem.properties as unknown as string) as Record<string, string>;
+        }
+      },
+    );
+
+    return result;
+  });
+}
+
+export type GroupedAreaChild = {
+  id: number;
+  title: string;
+  vectorSource: string;
+  sourceLayer: string;
+  featureId: number;
+  boundingBox: Polygon;
+  properties: Record<string, string>;
+};
+
+type ApiGroupedAreaChild = {
+  data: {
+    id: number;
+    title: string;
+    vector_source: string;
+    source_layer: string;
+    feature_id: number;
+    bounding_box: string;
+    properties: string;
+  };
+} & Omit<ApiSuccess, 'data'> | ApiError;
+
+export type ApiGroupedAreaChildData = Flatten<Exclude<ApiGroupedAreaChild, ApiError>['data']>;
+
+export const groupedAreaChildRevivers: Revivers<ApiGroupedAreaChild, GroupedAreaChild> = {
+  boundingBox: (data: ApiGroupedAreaChildData) => JSON.parse(data.bounding_box) as Polygon,
+  properties: (data: ApiGroupedAreaChildData) => JSON.parse(data.properties) as Record<string, string>,
+};
+
+export async function groupedAreaChildren(groupId: number, language: string): Promise<GroupedAreaChild[]> {
+  const pathname = `/v1/choropleth/groups/${groupId}/children-optimized`;
+  const query = getSearchParams({ language });
+  const path = `${pathname}?${query}`;
+  const options = { revivers: groupedAreaChildRevivers };
+
+  type ApiApiGroupedAreaChildArray = {
+    data: ApiGroupedAreaChildData[];
+  } & Omit<ApiSuccess, 'data'> | ApiError;
+
+  return request<ApiApiGroupedAreaChildArray, GroupedAreaChild>(path, null, null, options);
+}

package/src/api/color.ts

@@ -0,0 +1,22 @@
+import type { ApiCommonData, ApiError, ApiSuccess, Flatten, Revivers } from '../utils.js';
+
+export type Color = {
+  id: number;
+  hex: string;
+};
+
+export type ApiColor = {
+  data: {
+    id: number;                 // The color id (sortable)
+    name: string;               // The name of the color (searchable, sortable)
+    hex: string;                // The hex value of the color (searchable, sortable)
+    order?: number;             // TODO: not present in API specification!
+  } & ApiCommonData;
+} & Omit<ApiSuccess, 'data'> | ApiError;
+
+export type ApiColorData = Flatten<Exclude<ApiColor, ApiError>['data']>;
+
+export const colorRevivers: Revivers<ApiColor, Color> = {
+  name: undefined,
+  order: undefined,
+};