@equinor/fusion-services 0.2.0

package/dist/esm/roles/endpoints/system.get.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import { extractVersion, parseVersionedArgs, versionedResponseSelector } from '../../utils';
+import { ApiVersion } from '../static';
+import { ApiSystemSchemaV1 } from '../v1/schemas/api-system-schema-v1';
+/**
+ * Version contract for `getSystem`, implementing `GET /systems/{systemIdentifier}`.
+ *
+ * Each concrete {@link ApiVersion} maps to the argument and response schemas that
+ * version publishes, so the version a caller passes is the single discriminator
+ * for the request shape, the request path, and the response shape.
+ */
+const VersionContract = {
+    [ApiVersion.v1]: {
+        /** Arguments accepted by version 1.0 of this operation. */
+        args: z
+            .object({
+            /** System UUID or unique system name. */
+            systemIdentifier: z.string().describe('System UUID or unique system name.'),
+        })
+            .describe('Arguments for GET /systems/{systemIdentifier} (getSystem v1.0).'),
+        /** Response published by version 1.0 of this operation. */
+        response: ApiSystemSchemaV1,
+    },
+};
+/** Builds the request init for the resolved version, including its response-schema selector. */
+const generateRequestParameters = (version, _args, init) => {
+    // Select the response schema that matches the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            const baseInit = {
+                selector: versionedResponseSelector(VersionContract, version),
+            };
+            // Apply the caller-supplied `init` first, then the generated defaults, so the
+            // version-specific response `selector` always wins and cannot be bypassed.
+            return Object.assign({}, init, baseInit);
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/** Builds the request path for the resolved version, including its `api-version` parameter. */
+const generateApiPath = (version, args) => {
+    // Build the endpoint path according to the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            const params = new URLSearchParams();
+            params.append('api-version', version);
+            return `/systems/${encodeURIComponent(args.systemIdentifier)}?${String(params)}`;
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/**
+ * Fetches one registered system by its UUID or unique system name.
+ *
+ * Roles V2 operation: `GET /systems/{systemIdentifier}` — "Get a system by identifier."
+ *
+ * Curried in two stages: `getSystem(version, client, method)` binds the API version, the
+ * `IHttpClient` that reaches the Roles service, and the execution method — `'json'` for a
+ * promise, `'json$'` for an observable stream. The returned function takes {@link GetSystemArg}
+ * plus an optional `ClientRequestInit`, and gives back {@link GetSystemResult}.
+ *
+ * The version argument is the single discriminator: `'v1'` — equivalently `'1.0'` or
+ * `ApiVersion.v1` — selects the version-1.0 argument schema, validates the response with
+ * `ApiSystemSchemaV1`, and sends `api-version=1.0` on the request.
+ *
+ * Roles V2 answers `200 OK`; the body is typed `ApiSystemV1`.
+ *
+ * @template TVersion - Roles API version identifier: `'v1'`, `'1.0'`, or `ApiVersion.v1`.
+ * @template TMethod - Execution method: `'json'` for a promise, `'json$'` for an observable.
+ * @param version - API version selecting the request path, the argument schema, and the
+ * response schema.
+ * @param client - HTTP client that executes the request against the Roles service.
+ * @param method - Execution method, defaulting to `'json'`.
+ * @returns A request function taking {@link GetSystemArg} and an optional `ClientRequestInit`,
+ * returning {@link GetSystemResult}.
+ * @throws {Error} When `version` names an API version this operation does not publish. The
+ * check runs while binding, before the HTTP client is used.
+ * @throws {z.ZodError} From the returned function, when the arguments fail this version's
+ * argument schema or the response body fails its response schema.
+ *
+ * @example
+ * ```ts
+ * import { getSystem } from '@equinor/fusion-services/roles';
+ *
+ * const system = await getSystem('v1', httpClient)({ systemIdentifier: 'fusion-core' });
+ * ```
+ */
+const getSystem = (version, client, method = 'json') => {
+    const apiVersion = extractVersion(ApiVersion, version);
+    return (input, init) => {
+        const args = parseVersionedArgs(VersionContract, apiVersion, input);
+        return client[method](generateApiPath(apiVersion, args), generateRequestParameters(apiVersion, args, init));
+    };
+};
+// Every symbol is declared under its public name so hover and code completion show this
+// endpoint's own documentation. They are exported in one block rather than inline because an
+// inline `export const` would require renaming the file away from the `<resource>.<verb>`
+// convention that mirrors the OpenAPI operation it implements.
+// fusion-lint-disable-next-line no-separate-export
+export { getSystem, };
+//# sourceMappingURL=system.get.js.map

package/dist/esm/roles/endpoints/system.get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.get.js","sourceRoot":"","sources":["../../../../src/roles/endpoints/system.get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAcvE;;;;;;GAMG;AACH,MAAM,eAAe,GAAG;IACtB,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE;QACf,2DAA2D;QAC3D,IAAI,EAAE,CAAC;aACJ,MAAM,CAAC;YACN,yCAAyC;YACzC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SAC5E,CAAC;aACD,QAAQ,CAAC,iEAAiE,CAAC;QAC9E,2DAA2D;QAC3D,QAAQ,EAAE,iBAAiB;KAC5B;CACoC,CAAC;AAuCxC,gGAAgG;AAChG,MAAM,yBAAyB,GAAG,CAChC,OAAiB,EACjB,KAA4D,EAC5D,IAA8C,EACL,EAAE;IAC3C,qEAAqE;IACrE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAoE;gBAChF,QAAQ,EAAE,yBAAyB,CAAC,eAAe,EAAE,OAAO,CAAC;aAC9D,CAAC;YACF,8EAA8E;YAC9E,2EAA2E;YAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,eAAe,GAAG,CACtB,OAAiB,EACjB,IAA2D,EACnD,EAAE;IACV,kEAAkE;IAClE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,YAAY,kBAAkB,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACnF,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,SAAS,GAAG,CAChB,OAAiB,EACjB,MAAmB,EACnB,MAAM,GAAY,MAAiB,EACnC,EAAE;IAEF,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,CACL,KAAkC,EAClC,IAAuE,EAC9B,EAAE;QAC3C,MAAM,IAAI,GAAG,kBAAkB,CAAC,eAAe,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,MAAM,CAAC,MAAM,CAAC,CACnB,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,EACjC,yBAAyB,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CACP,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,wFAAwF;AACxF,6FAA6F;AAC7F,0FAA0F;AAC1F,+DAA+D;AAC/D,mDAAmD;AACnD,OAAO,EAKL,SAAS,GACV,CAAC"}

package/dist/esm/roles/endpoints/system.patch.js

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+import { extractVersion, parseVersionedArgs, versionedResponseSelector } from '../../utils';
+import { ApiVersion } from '../static';
+import { ApiSystemSchemaV1 } from '../v1/schemas/api-system-schema-v1';
+import { UpdateSystemRequestSchemaV1 } from '../v1/schemas/update-system-request-schema-v1';
+/**
+ * Version contract for `updateSystem`, implementing `PATCH /systems/{systemIdentifier}`.
+ *
+ * Each concrete {@link ApiVersion} maps to the argument and response schemas that
+ * version publishes, so the version a caller passes is the single discriminator
+ * for the request shape, the request path, and the response shape.
+ */
+const VersionContract = {
+    [ApiVersion.v1]: {
+        /** Arguments accepted by version 1.0 of this operation. */
+        args: z
+            .object({
+            /** System UUID or unique system name. */
+            systemIdentifier: z.string().describe('System UUID or unique system name.'),
+            ...UpdateSystemRequestSchemaV1.shape,
+        })
+            .describe('Arguments for PATCH /systems/{systemIdentifier} (updateSystem v1.0).'),
+        /** Response published by version 1.0 of this operation. */
+        response: ApiSystemSchemaV1,
+    },
+};
+/** Builds the request init for the resolved version, including its response-schema selector. */
+const generateRequestParameters = (version, args, init) => {
+    // Select the response schema that matches the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            // Path identifiers address the resource, so only the remaining fields form the request body.
+            const { systemIdentifier: _systemIdentifier, ...body } = args;
+            const baseInit = {
+                method: 'PATCH',
+                selector: versionedResponseSelector(VersionContract, version),
+                body,
+            };
+            // Apply the caller-supplied `init` first, then the generated defaults, so the
+            // generated `method`, `body`, and version-specific response `selector` always win
+            // and cannot be overridden or bypassed.
+            return Object.assign({}, init, baseInit);
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/** Builds the request path for the resolved version, including its `api-version` parameter. */
+const generateApiPath = (version, args) => {
+    // Build the endpoint path according to the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            const params = new URLSearchParams();
+            params.append('api-version', version);
+            return `/systems/${encodeURIComponent(args.systemIdentifier)}?${String(params)}`;
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/**
+ * Updates the description or owner list of a registered system.
+ *
+ * Roles V2 operation: `PATCH /systems/{systemIdentifier}` — "Update an existing system."
+ *
+ * Curried in two stages: `updateSystem(version, client, method)` binds the API version, the
+ * `IHttpClient` that reaches the Roles service, and the execution method — `'json'` for a
+ * promise, `'json$'` for an observable stream. The returned function takes
+ * {@link UpdateSystemArg} plus an optional `ClientRequestInit`, and gives back
+ * {@link UpdateSystemResult}.
+ *
+ * The version argument is the single discriminator: `'v1'` — equivalently `'1.0'` or
+ * `ApiVersion.v1` — selects the version-1.0 argument schema, validates the response with
+ * `ApiSystemSchemaV1`, and sends `api-version=1.0` on the request.
+ *
+ * Roles V2 answers `200 OK`; the body is typed `ApiSystemV1`. Fields left out of the arguments
+ * are not sent, so they keep their stored values. The contract declares `403 Forbidden` for
+ * callers the Roles service does not authorise for this operation.
+ *
+ * @template TVersion - Roles API version identifier: `'v1'`, `'1.0'`, or `ApiVersion.v1`.
+ * @template TMethod - Execution method: `'json'` for a promise, `'json$'` for an observable.
+ * @param version - API version selecting the request path, the argument schema, and the
+ * response schema.
+ * @param client - HTTP client that executes the request against the Roles service.
+ * @param method - Execution method, defaulting to `'json'`.
+ * @returns A request function taking {@link UpdateSystemArg} and an optional
+ * `ClientRequestInit`, returning {@link UpdateSystemResult}.
+ * @throws {Error} When `version` names an API version this operation does not publish. The
+ * check runs while binding, before the HTTP client is used.
+ * @throws {z.ZodError} From the returned function, when the arguments fail this version's
+ * argument schema or the response body fails its response schema.
+ *
+ * @example
+ * ```ts
+ * import { updateSystem } from '@equinor/fusion-services/roles';
+ *
+ * const system = await updateSystem('v1', httpClient)({
+ *   systemIdentifier: 'fusion-core',
+ *   description: 'Fusion core platform',
+ * });
+ * ```
+ */
+const updateSystem = (version, client, method = 'json') => {
+    const apiVersion = extractVersion(ApiVersion, version);
+    return (input, init) => {
+        const args = parseVersionedArgs(VersionContract, apiVersion, input);
+        return client[method](generateApiPath(apiVersion, args), generateRequestParameters(apiVersion, args, init));
+    };
+};
+// Every symbol is declared under its public name so hover and code completion show this
+// endpoint's own documentation. They are exported in one block rather than inline because an
+// inline `export const` would require renaming the file away from the `<resource>.<verb>`
+// convention that mirrors the OpenAPI operation it implements.
+// fusion-lint-disable-next-line no-separate-export
+export { updateSystem, };
+//# sourceMappingURL=system.patch.js.map

package/dist/esm/roles/endpoints/system.patch.js.map

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

package/dist/esm/roles/endpoints/systems.get.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { extractVersion, parseVersionedArgs, versionedResponseSelector } from '../../utils';
+import { ApiVersion } from '../static';
+import { ApiSystemSchemaV1 } from '../v1/schemas/api-system-schema-v1';
+import { SkipSchemaV1 } from '../v1/schemas/skip-schema-v1';
+import { TopSchemaV1 } from '../v1/schemas/top-schema-v1';
+import { apiPagedCollectionSchemaV1 } from '../v1/schemas/api-paged-collection-schema-v1';
+/**
+ * Version contract for `listSystems`, implementing `GET /systems`.
+ *
+ * Each concrete {@link ApiVersion} maps to the argument and response schemas that
+ * version publishes, so the version a caller passes is the single discriminator
+ * for the request shape, the request path, and the response shape.
+ */
+const VersionContract = {
+    [ApiVersion.v1]: {
+        /** Arguments accepted by version 1.0 of this operation. */
+        args: z
+            .object({
+            /** Maximum number of records to return. Roles V2 accepts values from 0 through 100. */
+            top: TopSchemaV1,
+            /** Number of records to skip before returning results. */
+            skip: SkipSchemaV1,
+        })
+            .describe('Arguments for GET /systems (listSystems v1.0).'),
+        /** Response published by version 1.0 of this operation. */
+        response: apiPagedCollectionSchemaV1(ApiSystemSchemaV1),
+    },
+};
+/** Builds the request init for the resolved version, including its response-schema selector. */
+const generateRequestParameters = (version, _args, init) => {
+    // Select the response schema that matches the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            const baseInit = {
+                selector: versionedResponseSelector(VersionContract, version),
+            };
+            // Apply the caller-supplied `init` first, then the generated defaults, so the
+            // version-specific response `selector` always wins and cannot be bypassed.
+            return Object.assign({}, init, baseInit);
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/** Builds the request path for the resolved version, including its `api-version` parameter. */
+const generateApiPath = (version, args) => {
+    // Build the endpoint path according to the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            const params = new URLSearchParams();
+            params.append('api-version', version);
+            args.top !== undefined && params.append('$top', String(args.top));
+            args.skip !== undefined && params.append('$skip', String(args.skip));
+            return `/systems?${String(params)}`;
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/**
+ * Lists the systems registered with the Roles service.
+ *
+ * Roles V2 operation: `GET /systems` — "Get all systems."
+ *
+ * Curried in two stages: `listSystems(version, client, method)` binds the API version, the
+ * `IHttpClient` that reaches the Roles service, and the execution method — `'json'` for a
+ * promise, `'json$'` for an observable stream. The returned function takes
+ * {@link ListSystemsArg} plus an optional `ClientRequestInit`, and gives back
+ * {@link ListSystemsResult}.
+ *
+ * The version argument is the single discriminator: `'v1'` — equivalently `'1.0'` or
+ * `ApiVersion.v1` — selects the version-1.0 argument schema, validates the response with
+ * `apiPagedCollectionSchemaV1(ApiSystemSchemaV1)`, and sends `api-version=1.0` on the request.
+ *
+ * Query options: `top` and `skip` page the collection as `$top` and `$skip` (`top` accepts
+ * 0–100).
+ *
+ * Roles V2 answers `200 OK`; the body is typed `ApiPagedCollectionV1<ApiSystemV1>`.
+ *
+ * @template TVersion - Roles API version identifier: `'v1'`, `'1.0'`, or `ApiVersion.v1`.
+ * @template TMethod - Execution method: `'json'` for a promise, `'json$'` for an observable.
+ * @param version - API version selecting the request path, the argument schema, and the
+ * response schema.
+ * @param client - HTTP client that executes the request against the Roles service.
+ * @param method - Execution method, defaulting to `'json'`.
+ * @returns A request function taking {@link ListSystemsArg} and an optional
+ * `ClientRequestInit`, returning {@link ListSystemsResult}.
+ * @throws {Error} When `version` names an API version this operation does not publish. The
+ * check runs while binding, before the HTTP client is used.
+ * @throws {z.ZodError} From the returned function, when the arguments fail this version's
+ * argument schema or the response body fails its response schema.
+ *
+ * @example
+ * ```ts
+ * import { listSystems } from '@equinor/fusion-services/roles';
+ *
+ * const page = await listSystems('v1', httpClient)({ top: 25 });
+ * ```
+ */
+const listSystems = (version, client, method = 'json') => {
+    const apiVersion = extractVersion(ApiVersion, version);
+    return (input, init) => {
+        // The operation has no required arguments, so an omitted argument object parses as empty.
+        const args = parseVersionedArgs(VersionContract, apiVersion, input ?? {});
+        return client[method](generateApiPath(apiVersion, args), generateRequestParameters(apiVersion, args, init));
+    };
+};
+// Every symbol is declared under its public name so hover and code completion show this
+// endpoint's own documentation. They are exported in one block rather than inline because an
+// inline `export const` would require renaming the file away from the `<resource>.<verb>`
+// convention that mirrors the OpenAPI operation it implements.
+// fusion-lint-disable-next-line no-separate-export
+export { listSystems, };
+//# sourceMappingURL=systems.get.js.map

package/dist/esm/roles/endpoints/systems.get.js.map

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

package/dist/esm/roles/endpoints/systems.post.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { extractVersion, parseVersionedArgs, versionedResponseSelector } from '../../utils';
+import { ApiVersion } from '../static';
+import { ApiSystemSchemaV1 } from '../v1/schemas/api-system-schema-v1';
+import { RegisterSystemRequestSchemaV1 } from '../v1/schemas/register-system-request-schema-v1';
+/**
+ * Version contract for `createSystem`, implementing `POST /systems`.
+ *
+ * Each concrete {@link ApiVersion} maps to the argument and response schemas that
+ * version publishes, so the version a caller passes is the single discriminator
+ * for the request shape, the request path, and the response shape.
+ */
+const VersionContract = {
+    [ApiVersion.v1]: {
+        /** Arguments accepted by version 1.0 of this operation. */
+        args: z
+            .object({
+            ...RegisterSystemRequestSchemaV1.shape,
+        })
+            .describe('Arguments for POST /systems (createSystem v1.0).'),
+        /** Response published by version 1.0 of this operation. */
+        response: ApiSystemSchemaV1,
+    },
+};
+/** Builds the request init for the resolved version, including its response-schema selector. */
+const generateRequestParameters = (version, args, init) => {
+    // Select the response schema that matches the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            // The operation takes no path identifiers, so every argument belongs to the request body.
+            const body = { ...args };
+            const baseInit = {
+                method: 'POST',
+                selector: versionedResponseSelector(VersionContract, version),
+                body,
+            };
+            // Apply the caller-supplied `init` first, then the generated defaults, so the
+            // generated `method`, `body`, and version-specific response `selector` always win
+            // and cannot be overridden or bypassed.
+            return Object.assign({}, init, baseInit);
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/** Builds the request path for the resolved version, including its `api-version` parameter. */
+const generateApiPath = (version, _args) => {
+    // Build the endpoint path according to the requested API version.
+    switch (version) {
+        case ApiVersion.v1: {
+            const params = new URLSearchParams();
+            params.append('api-version', version);
+            return `/systems?${String(params)}`;
+        }
+    }
+    throw Error(`Unknown API version: ${version}`);
+};
+/**
+ * Registers a system with the Fusion Roles V2 service.
+ *
+ * Roles V2 operation: `POST /systems` — "Create a new system."
+ *
+ * Curried in two stages: `createSystem(version, client, method)` binds the API version, the
+ * `IHttpClient` that reaches the Roles service, and the execution method — `'json'` for a
+ * promise, `'json$'` for an observable stream. The returned function takes
+ * {@link CreateSystemArg} plus an optional `ClientRequestInit`, and gives back
+ * {@link CreateSystemResult}.
+ *
+ * The version argument is the single discriminator: `'v1'` — equivalently `'1.0'` or
+ * `ApiVersion.v1` — selects the version-1.0 argument schema, validates the response with
+ * `ApiSystemSchemaV1`, and sends `api-version=1.0` on the request.
+ *
+ * Roles V2 answers `201 Created`; the body is typed `ApiSystemV1`. A colliding name answers
+ * `409 Conflict`. The contract declares `403 Forbidden` for callers the Roles service does not
+ * authorise for this operation.
+ *
+ * @template TVersion - Roles API version identifier: `'v1'`, `'1.0'`, or `ApiVersion.v1`.
+ * @template TMethod - Execution method: `'json'` for a promise, `'json$'` for an observable.
+ * @param version - API version selecting the request path, the argument schema, and the
+ * response schema.
+ * @param client - HTTP client that executes the request against the Roles service.
+ * @param method - Execution method, defaulting to `'json'`.
+ * @returns A request function taking {@link CreateSystemArg} and an optional
+ * `ClientRequestInit`, returning {@link CreateSystemResult}.
+ * @throws {Error} When `version` names an API version this operation does not publish. The
+ * check runs while binding, before the HTTP client is used.
+ * @throws {z.ZodError} From the returned function, when the arguments fail this version's
+ * argument schema or the response body fails its response schema.
+ *
+ * @example
+ * ```ts
+ * import { createSystem } from '@equinor/fusion-services/roles';
+ *
+ * const system = await createSystem('v1', httpClient)({
+ *   name: 'fusion-core',
+ *   description: 'Fusion core platform',
+ * });
+ * ```
+ */
+const createSystem = (version, client, method = 'json') => {
+    const apiVersion = extractVersion(ApiVersion, version);
+    return (input, init) => {
+        // The operation has no required arguments, so an omitted argument object parses as empty.
+        const args = parseVersionedArgs(VersionContract, apiVersion, input ?? {});
+        return client[method](generateApiPath(apiVersion, args), generateRequestParameters(apiVersion, args, init));
+    };
+};
+// Every symbol is declared under its public name so hover and code completion show this
+// endpoint's own documentation. They are exported in one block rather than inline because an
+// inline `export const` would require renaming the file away from the `<resource>.<verb>`
+// convention that mirrors the OpenAPI operation it implements.
+// fusion-lint-disable-next-line no-separate-export
+export { createSystem, };
+//# sourceMappingURL=systems.post.js.map

package/dist/esm/roles/endpoints/systems.post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systems.post.js","sourceRoot":"","sources":["../../../../src/roles/endpoints/systems.post.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iDAAiD,CAAC;AAchG;;;;;;GAMG;AACH,MAAM,eAAe,GAAG;IACtB,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE;QACf,2DAA2D;QAC3D,IAAI,EAAE,CAAC;aACJ,MAAM,CAAC;YACN,GAAG,6BAA6B,CAAC,KAAK;SACvC,CAAC;aACD,QAAQ,CAAC,kDAAkD,CAAC;QAC/D,2DAA2D;QAC3D,QAAQ,EAAE,iBAAiB;KAC5B;CACoC,CAAC;AAwCxC,gGAAgG;AAChG,MAAM,yBAAyB,GAAG,CAChC,OAAiB,EACjB,IAA2D,EAC3D,IAA8C,EACL,EAAE;IAC3C,qEAAqE;IACrE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,0FAA0F;YAC1F,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAuE;gBACnF,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,yBAAyB,CAAC,eAAe,EAAE,OAAO,CAAC;gBAC7D,IAAI;aACL,CAAC;YACF,8EAA8E;YAC9E,kFAAkF;YAClF,wCAAwC;YACxC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,eAAe,GAAG,CACtB,OAAiB,EACjB,KAA4D,EACpD,EAAE;IACV,kEAAkE;IAClE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,YAAY,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,YAAY,GAAG,CAInB,OAAiB,EACjB,MAAmB,EACnB,MAAM,GAAY,MAAiB,EACnC,EAAE;IAEF,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,CACL,KAAsC,EACtC,IAA0E,EAC9B,EAAE;QAC9C,0FAA0F;QAC1F,MAAM,IAAI,GAAG,kBAAkB,CAAC,eAAe,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,CACnB,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,EACjC,yBAAyB,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CACJ,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,wFAAwF;AACxF,6FAA6F;AAC7F,0FAA0F;AAC1F,+DAA+D;AAC/D,mDAAmD;AACnD,OAAO,EAKL,YAAY,GACb,CAAC"}