Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Register Node specific MIME types #371

Closed
bmeck opened this issue Sep 28, 2017 · 24 comments
Closed

Register Node specific MIME types #371

bmeck opened this issue Sep 28, 2017 · 24 comments

Comments

@bmeck
Copy link
Member

bmeck commented Sep 28, 2017

I would like to register a few new MIMEs under the Node Foundation's authority in the IANA Registry . This would allow some better interop and disambiguation with various APIs using MIME types or overlap with ESM and CJS module systems.

In particular I would like to register:

Security Considerations: ... TODO ...
File Extensions: .js
Change Controller: Node Foundation

  • application/vnd.node.node

Security Considerations: Used as a container format to execute code directly on the host within the Node Process. All permissions of the host process will be granted to the code within the resource.
File Extensions: .node
Change Controller: Node Foundation

@jasnell
Copy link
Member

jasnell commented Sep 28, 2017

+1 on this.

What do you intend to put for the contact information for the registration? I would propose that the TSC, in general, be listed as the authority for the registrations.

@bmeck
Copy link
Member Author

bmeck commented Sep 28, 2017

I'm fine w/ whatever, "Node Foundation TSC"?

@jasnell
Copy link
Member

jasnell commented Sep 28, 2017 via email

@TimothyGu
Copy link
Member

Is it "Node Foundation" or "Node.js Foundation"?

@jasnell
Copy link
Member

jasnell commented Sep 28, 2017 via email

@mhdawson
Copy link
Member

+1 from me

@bmeck
Copy link
Member Author

bmeck commented Sep 29, 2017

draft just needs contact name + email I think.

Type Name: text
Subtype Name: vnd.node.js
Require Parameters: none
Optional Parameters: none
Encoding Considerations: 8 bit text, utf8
Security Considerations:

  The resource is given access to all of Node.js's module system.
  This includes code execution, filesystem access, and network access.
  Ensuring security is left up to the host running the resource.

Interoperability Considerations:

  The registration occupies the same file extension as other media types.
  The media type of the file extension should be considered ambiguous if the intended execution environment is unknown.

Published Specification: https://nodejs.org/api/modules.html
Application Usage:

  Node.js CommonJS execution environments
  Node.js CommonJS package managers
  Node.js CommonJS module tools

Fragment Identifier Considerations: none
Restrictions on Usage: none
Provisional Registrations: none
Additional Information:

  Deprecated alias names for this type: none
  Magic number(s): none
  File extension(s): .js
  Macintosh File Type Code(s): TEXT
  Object Identifier(s) or OID(s): none

Intended Usage: Common
Other Information & Comments:

  See also text/javascript which also occupies the same file extension.
  See the CommonJS specification for Module which Node.js is a variant of.
  This usage of the .js file extension is extremely prolific on the public `npm` registry ( https://www.npmjs.com/ ) with millions of downloads of packages a day.
  If text type name is not appropriate, application works as well. text is slightly preferred since https://html.spec.whatwg.org/multipage/scripting.html#prepare-a-script used text/javascript instead of application/javascript.

Contact Person: Node.js Technical Steering Committee
Contact Email Address: tsc@iojs.org
Author/Change Controller: Node.js Technical Steering Committee
Type Name: application
Subtype Name: vnd.node.node
Require Parameters: none
Optional Parameters: none
Encoding Considerations: binary
Security Considerations:

  The resource is given access to arbitrary code execution on the host.
  Ensuring security is left up to the host running the resource.

Interoperability Considerations:

  This format is not safe to transfer between different architectures or operating environments.

Published Specification: https://nodejs.org/api/addons.html
Application Usage:

  Node.js execution environments
  Node.js package managers
  Node.js module tools

Fragment Identifier Considerations: none
Restrictions on Usage: none
Provisional Registrations: none
Additional Information:

  Deprecated alias names for this type: none
  Magic number(s): none
  File extension(s): .node
  Macintosh File Type Code(s): BINA
  Object Identifier(s) or OID(s): none

Intended Usage: Common
Other Information & Comments:

Contact Person: Node.js Technical Steering Committee
Contact Email Address: tsc@iojs.org
Author/Change Controller: Node.js Technical Steering Committee

@jasnell
Copy link
Member

jasnell commented Sep 29, 2017

For Contact Person, I would just say "Node.js Technical Steering Committee"
and tsc@iojs.org as the contact email.

@Fishrock123
Copy link
Contributor

This usage of the .js file extension is extremely prolific on the public npm registry ( https://www.npmjs.com/ ) with millions of downloads of package a day.

packages


These look good to me otherwise. I'd say the contact email should be the tsc email, and if we cannot put the TSC as the "contact person" I suggest we put the chair, @mhdawson.

@jasnell
Copy link
Member

jasnell commented Oct 2, 2017

Given that registrations are long lived and the chair can change year to year, it's not a great idea to list @mhdawson. The tsc email should be just fine

@bmeck
Copy link
Member Author

bmeck commented Oct 3, 2017

I am reading 6 +1s, at 11 I think we are ok to start submission it looks like (TSC currently has 21 members)? Or is there a simpler way to determine if it is something that is ok to start?

@MylesBorins
Copy link
Contributor

MylesBorins commented Oct 3, 2017 via email

@mcollina
Copy link
Member

mcollina commented Oct 3, 2017

SGTM

@bmeck
Copy link
Member Author

bmeck commented Oct 3, 2017

@MylesBorins I'm fine w/ consensus since it will still take a bit of time to land in IANA

@Trott
Copy link
Member

Trott commented Oct 4, 2017

Yes, with very few exceptions, we only vote when consensus-seeking fails. If this has been open for many days, has multiple approvals, and has no objections, then you can move forward with it.

@mrhinkle
Copy link

mrhinkle commented Nov 2, 2017

@jasnell what do you think about doing the registration with tsc@nodejs.org which just points to tsc@iojs.org since that is the official domain of the project it will look a little more legit, IMHO.

@bmeck
Copy link
Member Author

bmeck commented Nov 6, 2017

The vnd.node.node request has been denied since it does not have a consistent content body type. It varies per platform with .so, .dll, and .dylib formats.

@fhinkel
Copy link
Member

fhinkel commented Nov 15, 2017

+1

@mhdawson
Copy link
Member

@MylesBorins in the last TSC meeting we were not sure what the question was for the TSC. Can you add some context.

@joyeecheung
Copy link
Member

SGTM

@bmeck
Copy link
Member Author

bmeck commented Nov 29, 2017

This has been sent of w/ TSC as the organization per todays meeting.

@Trott
Copy link
Member

Trott commented Nov 30, 2017

Should we remove the tsc-agenda label at this time?

@bmeck
Copy link
Member Author

bmeck commented Nov 30, 2017

@Trott yes

@bmeck
Copy link
Member Author

bmeck commented Dec 12, 2017

Done. https://www.iana.org/assignments/media-types/application/node

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests