ducky/src/ducky-2-registry-2-api.js

Duck-Typed Value Handling for JavaScript

/*
**  Ducky -- Duck-Typed Value Handling for JavaScript
**  Copyright (c) 2010-2023 Dr. Ralf S. Engelschall <rse@engelschall.com>
**
**  Permission is hereby granted, free of charge, to any person obtaining
**  a copy of this software and associated documentation files (the
**  "Software"), to deal in the Software without restriction, including
**  without limitation the rights to use, copy, modify, merge, publish,
**  distribute, sublicense, and/or sell copies of the Software, and to
**  permit persons to whom the Software is furnished to do so, subject to
**  the following conditions:
**
**  The above copyright notice and this permission notice shall be included
**  in all copies or substantial portions of the Software.
**
**  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
**  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
**  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
**  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
**  CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
**  TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
**  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/

import { registry } from "./ducky-2-registry-1-data.js"

/*  API function: register a type under a name  */
const register = function (name, type) {
    /*  sanity check arguments  */
    if (arguments.length !== 2)
        throw new Error(`register: invalid number of arguments: ${arguments.length} (exactly 2 expected)`)
    if (typeof name !== "string")
        throw new Error(`register: invalid name argument: "${name}" (string expected)`)
    if (typeof type !== "function")
        throw new Error(`register: invalid type argument: "${type}" (function object expected)`)
    if (typeof registry[name] !== "undefined")
        throw new Error(`register: type already registered under name: "${name}"`)

    /*  add type to registry  */
    registry[name] = type
}

/*  API function: unregister a type under a name  */
const unregister = function (name) {
    /*  sanity check arguments  */
    if (arguments.length !== 1)
        throw new Error(`unregister: invalid number of arguments: ${arguments.length} (exactly 1 expected)`)
    if (typeof name !== "string")
        throw new Error(`unregister: invalid name argument: "${name}" (string expected)`)
    if (typeof registry[name] === "undefined")
        throw new Error(`unregister: no type registered under name: "${name}"`)

    /*  delete type from registry  */
    delete registry[name]
}

/*  API function: check for registered type under a name  */
const registered = function (name) {
    /*  sanity check arguments  */
    if (arguments.length !== 1)
        throw new Error(`registered: invalid number of arguments: ${arguments.length} (exactly 1 expected)`)
    if (typeof name !== "string")
        throw new Error(`registered: invalid name argument: "${name}" (string expected)`)
    return registry[name]
}

export { registered, register, unregister }