ctx-core 2.2.0 → 2.2.1

package/all/unauthorized/index.js

@@ -0,0 +1,43 @@
+import { assign } from '../assign/index.js'
+import { HttpError } from '../http_error/index.js'
+/** @typedef {import('../error_o/index.d.ts').argument__error_o_T} */
+export const unauthorized__default__message = 'Unauthorized'
+/**
+ * @param {string}[message]
+ * @param {argument__error_o_T}[error_o]
+ * @returns {UnauthorizedError}
+ * @private
+ */
+export function unauthorized_error_(
+	message,
+	error_o
+) {
+	return assign(
+		new UnauthorizedError(message ?? unauthorized__default__message),
+		error_o)
+}
+/**
+ * Throws an unauthorized error (HTTP 401)
+ * @param {string}[message]
+ * @param {argument__error_o_T}[error_o]
+ * @example
+ * unauthorized_throw(ctx) // Unauthorized
+ */
+export function unauthorized__throw(
+	message,
+	error_o
+) {
+	throw unauthorized_error_(message, error_o)
+}
+/** @type {import('./index.d.ts').UnauthorizedError} */
+export class UnauthorizedError extends HttpError {
+	/**
+	 * @param {string}[message]
+	 */
+	constructor(message) {
+		super(message)
+		this.name = 'UnauthorizedError'
+		this.http__message = unauthorized__default__message
+		if (!this.message) this.message = this.http__message
+	}
+}

package/all/unformat_currency_str/index.d.ts

@@ -0,0 +1,10 @@
+import type { currency_str__default_params_T } from '../currency_str/index.js'
+import type { nullish } from '../nullish/index.js'
+export declare function unformat_currency_str_(
+	amount:string|number|nullish,
+	params?:currency_str__default_params_T|string
+):string|null
+export {
+	unformat_currency_str_ as _unformat_currency_str,
+	unformat_currency_str_ as unformat__currency,
+}

package/all/unformat_currency_str/index.js

@@ -0,0 +1,27 @@
+import { currency_symbol_ } from '../currency_symbol/index.js'
+import { no_comma_str_ } from '../no_comma_str/index.js'
+/** @typedef {import('../nullish/index.d.ts').nullish} */
+/** @typedef {import('../currency_str/index.d.ts').currency_str__default_params_T} */
+/**
+ * Remove currency delimiter & commas from the string representation of amount.
+ */
+/**
+ * @param {string|number|nullish}amount
+ * @param {currency_str__default_params_T|string}params
+ * @returns {string|null}
+ */
+export function unformat_currency_str_(
+	amount,
+	params
+) {
+	return (
+		amount == null
+			? params?.default || null
+			: no_comma_str_(
+				amount.toString().replace(
+					currency_symbol_(params), '')))
+}
+export {
+	unformat_currency_str_ as _unformat_currency_str,
+	unformat_currency_str_ as unformat__currency,
+}

package/all/uniform_random/index.d.ts

@@ -0,0 +1,2 @@
+export declare function uniform_random_():number
+export { uniform_random_ as _random__uniform }

package/all/uniform_random/index.js

@@ -0,0 +1,4 @@
+export function uniform_random_() {
+	return Math.random()
+}
+export { uniform_random_ as _random__uniform }

package/all/uniform_random_float/index.d.ts

@@ -0,0 +1,2 @@
+export declare function uniform_random_float_(min?:number, max?:number):number
+export { uniform_random_float_ as _float__random__uniform }

package/all/uniform_random_float/index.js

@@ -0,0 +1,6 @@
+import { distribution_random_float_ } from '../distribution_random_float/index.js'
+import { uniform_random_ } from '../uniform_random/index.js'
+export function uniform_random_float_(min = 0.0, max = 1.0) {
+	return distribution_random_float_(min, max, uniform_random_)
+}
+export { uniform_random_float_ as _float__random__uniform }

package/all/uniform_random_int/index.d.ts

@@ -0,0 +1,2 @@
+export declare function uniform_random_int_(min?:number, max?:number):number
+export { uniform_random_int_ as _int__random__uniform }

package/all/uniform_random_int/index.js

@@ -0,0 +1,6 @@
+import { distribution_random_int_ } from '../distribution_random_int/index.js'
+import { uniform_random_ } from '../uniform_random/index.js'
+export function uniform_random_int_(min = 0, max = 1) {
+	return distribution_random_int_(min, max, uniform_random_)
+}
+export { uniform_random_int_ as _int__random__uniform }

package/all/union_a/index.d.ts

@@ -0,0 +1,14 @@
+import type { a_nowrap_T } from '../a_nowrap/index.js'
+import type { wrap_aa_item_T } from '../wrap_aa_item/index.js'
+/**
+ * Returns the union of n arrays
+ * @see {@link http://www.2ality.com/2015/01/es6-set-operations.html}
+ */
+export declare function union_a_<I extends unknown = unknown>(
+	aa_nowrap:a_nowrap_T<I>
+):wrap_aa_item_T<I>[]
+export {
+	union_a_ as _union__a1,
+	union_a_ as _uniq,
+	union_a_ as _uniq__a1,
+}

package/all/union_a/index.js

@@ -0,0 +1,18 @@
+import { union_set_ } from '../union_set/index.js'
+import { wrap_aa_ } from '../wrap_aa/index.js'
+/**
+ * Returns the union of n arrays
+ * @see {@link http://www.2ality.com/2015/01/es6-set-operations.html}
+ * @param {import('../a_nowrap/index.js').a_nowrap_T}aa_nowrap
+ * @returns {import('../wrap_aa_item/index.js').wrap_aa_item_T[]}
+ * @private
+ */
+export function union_a_(aa_nowrap) {
+	const a2 = wrap_aa_(aa_nowrap)
+	return Array.from(union_set_(a2))
+}
+export {
+	union_a_ as _union__a1,
+	union_a_ as _uniq,
+	union_a_ as _uniq__a1,
+}

package/all/union_by/index.d.ts

@@ -0,0 +1,11 @@
+import type { wrap_aa_item_T } from '../wrap_aa_item/index.js'
+export declare function union_by_<
+	I extends unknown, O extends unknown
+>(
+	aa_nowrap:I,
+	by_?:(v:wrap_aa_item_T<I>)=>O
+):wrap_aa_item_T<I>[]
+export {
+	union_by_ as _union_by,
+	union_by_ as _union__by,
+}

package/all/union_by/index.js

@@ -0,0 +1,28 @@
+import { wrap_aa_ } from '../wrap_aa/index.js'
+/** @typedef {import('../wrap_aa_item/index.d.ts').wrap_aa_item_T}wrap_aa_item_T */
+/**
+ * @param {unknown}aa_nowrap
+ * @param {(v:wrap_aa_item_T)=>union_by_}[by_]
+ * @returns {unknown[]}
+ */
+export function union_by_(aa_nowrap, by_ = v=>v) {
+	const a2 = wrap_aa_(aa_nowrap)
+	const set = new Set()
+	const union = []
+	for (let i = 0; i < a2.length; i++) {
+		const a = a2[i]
+		for (let j = 0; j < a.length; j++) {
+			const item = a[j]
+			const by = by_(item)
+			if (!set.has(by)) {
+				set.add(by)
+				union.push(item)
+			}
+		}
+	}
+	return union
+}
+export {
+	union_by_ as _union_by,
+	union_by_ as _union__by,
+}

package/all/union_set/index.d.ts

@@ -0,0 +1,14 @@
+import type { wrap_aa_T } from '../wrap_aa/index.js'
+/**
+ * Returns a `set` with the union of the members
+ * @see {@link http://www.2ality.com/2015/01/es6-set-operations.html}
+ */
+export declare function union_set_<
+	I extends unknown = unknown
+>(
+	member_a_nowrap_a_nowrap:Set<I>|wrap_aa_T<I>
+):Set<I>
+export {
+	union_set_ as set_union_fn,
+	union_set_ as _union__set,
+}

package/all/union_set/index.js

@@ -0,0 +1,18 @@
+import { wrap_a_ } from '../wrap_a/index.js'
+/**
+ * Returns a `set` with the union of the members
+ * @see {@link http://www.2ality.com/2015/01/es6-set-operations.html}
+ */
+export function union_set_(member_a_nowrap_a_nowrap) {
+	const member_a_nowrap_a = wrap_a_(member_a_nowrap_a_nowrap)
+	let set_member_a = []
+	for (let i = 0; i < member_a_nowrap_a.length; i++) {
+		const member_a = wrap_a_(member_a_nowrap_a[i])
+		set_member_a.push(...member_a)
+	}
+	return new Set(set_member_a)
+}
+export {
+	union_set_ as set_union_fn,
+	union_set_ as _union__set,
+}

package/all/unit_matrix/index.d.ts

@@ -0,0 +1 @@
+export declare function unit_matrix_(length:number):number[]

package/all/unit_matrix/index.js

@@ -0,0 +1,11 @@
+/**
+ * @param {number}length
+ * @returns {number[]}
+ */
+export function unit_matrix_(length) {
+	const unit_matrix = []
+	for (let i = 0; i < length; i++) {
+		unit_matrix.push(1)
+	}
+	return unit_matrix
+}

package/all/unpick/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Does not include `key_a` from `obj`
+ */
+export declare function unpick<
+	In extends Record<string, any> = object,
+	Out extends Partial<In> = Partial<In>
+>(obj:In, ...key_a:string[]):Partial<In>
+export declare function maybe_unpick<
+	In extends Record<string, any> = object,
+	Out extends Partial<In> = Partial<In>
+>(obj:In, ...key_a:string[]):void|Partial<In>

package/all/unpick/index.js

@@ -0,0 +1,28 @@
+import { assign } from '../assign/index.js'
+import { keys } from '../keys/index.js'
+/**
+ * Does not include `key_a` from `obj`
+ * @param {object}obj
+ * @param {string}key_a
+ * @returns {object}
+ */
+export function unpick(obj, ...key_a) {
+	const memo = {}
+	const obj_key_a = keys(obj)
+	for (let i = 0; i < obj_key_a.length; i++) {
+		const key = obj_key_a[i]
+		if (key_a.indexOf(key) === -1) assign(memo, {
+			[key]: obj[key]
+		})
+	}
+	return memo
+}
+/**
+ * @param {object}obj
+ * @param {string}key_a
+ * @returns {object|undefined}
+ */
+export function maybe_unpick(obj, ...key_a) {
+	if (!obj) return
+	return unpick(obj, ...key_a)
+}

package/all/unpick_keys/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Does not include keys on `keys_obj` from `obj`
+ */
+export declare function unpick_keys<
+	I extends object = object,
+	KEYS_OBJ extends object = object
+>(obj:I, keys_obj:KEYS_OBJ):Partial<I>
+export { unpick_keys as unpick__keys }

package/all/unpick_keys/index.js

@@ -0,0 +1,12 @@
+import { keys } from '../keys/index.js'
+import { unpick } from '../unpick/index.js'
+/**
+ * Does not include keys on `keys_obj` from `obj`
+ * @param {object}obj
+ * @param {object}keys_obj
+ * @returns {object}
+ */
+export function unpick_keys(obj, keys_obj) {
+	return unpick(obj, ...keys(keys_obj))
+}
+export { unpick_keys as unpick__keys }

package/all/url__join/index.d.ts

@@ -0,0 +1,5 @@
+import type { url_segment_T } from '../url_segment/index.js'
+export declare function url__join(url_segment_a:url_segment_T[]):string
+export {
+	url__join as join_url,
+}

package/all/url__join/index.js

@@ -0,0 +1,24 @@
+/**
+ * @param {import('../url_segment/index.js').url_segment_T[]}url_segment_a
+ * @returns {string}
+ */
+export function url__join(url_segment_a) {
+	return url_segment_a.reduce((
+		url,
+		url_segment
+	)=>{
+		const url_segment_str = url_segment.toString()
+		if (~[
+			'/',
+			'?',
+			'&'
+		].indexOf(url_segment_str.slice(0, 1))) {
+			return `${url}${url_segment_str}`
+		} else {
+			return `${url}/${url_segment_str}`
+		}
+	}, '')
+}
+export {
+	url__join as join_url,
+}

package/all/url_basename/index.d.ts

@@ -0,0 +1,2 @@
+export declare function url_basename_(url:string):string
+export { url_basename_ as _url_basename, }

package/all/url_basename/index.js

@@ -0,0 +1,10 @@
+/**
+ * @param {string}url
+ * @returns {string}
+ */
+export function url_basename_(url) {
+	if (!url) return url
+	const location = url.split('?')[0]
+	return location?.split('/').pop() || ''
+}
+export { url_basename_ as _url_basename, }

package/all/url_segment/index.d.ts

@@ -0,0 +1,2 @@
+export declare type url_segment_T = string|number|boolean
+export declare type urlSegmentT = url_segment_T

package/all/url_segment/index.js

@@ -0,0 +1 @@
+export {}

package/all/urn_url/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Converts a urn to a url
+ * @param {string} uri
+ * @returns {string}
+ * @see {@link https://danielmiessler.com/study/url-uri/}
+ */
+export declare function urn_url_(uri:string):string
+export {
+	urn_url_ as _urn_url,
+	urn_url_ as _url__urn,
+}

package/all/urn_url/index.js

@@ -0,0 +1,15 @@
+/**
+ * Converts a urn to a url
+ * @param {string} uri
+ * @returns {string}
+ * @see {@link https://danielmiessler.com/study/url-uri/}
+ */
+export function urn_url_(uri) {
+	if (!uri) return uri
+	if (uri.indexOf('//') === 0 || uri.indexOf('http://') === 0 || uri.indexOf('https://') === 0) return uri
+	return `//${uri}`
+}
+export {
+	urn_url_ as _urn_url,
+	urn_url_ as _url__urn,
+}

package/all/utc_MM_yyyy/index.d.ts

@@ -0,0 +1,8 @@
+export declare function utc_MM_yyyy_(date?:Date):string
+export declare function utc_mm_yyyy_(date?:Date):string
+export {
+	utc_MM_yyyy_ as _utc_MM_yyyy,
+	utc_MM_yyyy_ as _MM_yyyy__utc,
+	utc_mm_yyyy_ as _utc_mm_yyyy,
+	utc_mm_yyyy_ as _mm_yyyy__utc,
+}

package/all/utc_MM_yyyy/index.js

@@ -0,0 +1,24 @@
+import { month_a } from '../month_a/index.js'
+import { pad2 } from '../pad2/index.js'
+/**
+ * @param {Date}[date]
+ * @returns {string}
+ */
+export function utc_MM_yyyy_(date) {
+	date = date || new Date()
+	return `${month_a[date.getUTCMonth()]} ${date.getUTCFullYear()}`
+}
+/**
+ * @param date{Date}
+ * @returns {string}
+ */
+export function utc_mm_yyyy_(date) {
+	date = date || new Date()
+	return `${pad2(date.getUTCMonth() + 1)}/${date.getUTCFullYear()}`
+}
+export {
+	utc_MM_yyyy_ as _utc_MM_yyyy,
+	utc_MM_yyyy_ as _MM_yyyy__utc,
+	utc_mm_yyyy_ as _utc_mm_yyyy,
+	utc_mm_yyyy_ as _mm_yyyy__utc,
+}

package/all/utc_M_yyyy/index.d.ts

@@ -0,0 +1,6 @@
+export declare function utc_M_yyyy_(date?:Date):string
+export {
+	utc_M_yyyy_ as _utc_M_yyyy,
+	utc_M_yyyy_ as _M_yyyy__utc,
+}
+

package/all/utc_M_yyyy/index.js

@@ -0,0 +1,13 @@
+import { abbrev_month_a } from '../abbrev_month_a/index.js'
+/**
+ * @param {Date}[date]
+ * @returns {string}
+ */
+export function utc_M_yyyy_(date) {
+	date = date || new Date()
+	return `${abbrev_month_a[date.getUTCMonth()]} ${date.getUTCFullYear()}`
+}
+export {
+	utc_M_yyyy_ as _utc_M_yyyy,
+	utc_M_yyyy_ as _M_yyyy__utc,
+}

package/all/utc_m_yy/index.d.ts

@@ -0,0 +1,5 @@
+export declare function utc_m_yy_(date?:Date):string
+export {
+	utc_m_yy_ as _utc_m_yy,
+	utc_m_yy_ as _m_yy__utc,
+}

package/all/utc_m_yy/index.js

@@ -0,0 +1,12 @@
+/**
+ * @param {Date}[date]
+ * @returns {string}
+ */
+export function utc_m_yy_(date) {
+	date = date || new Date()
+	return `${date.getUTCMonth() + 1}/${date.getUTCFullYear().toString().slice(2)}`
+}
+export {
+	utc_m_yy_ as _utc_m_yy,
+	utc_m_yy_ as _m_yy__utc,
+}

package/all/utc_yyyymmdd/index.d.ts

@@ -0,0 +1,5 @@
+export declare function utc_yyyymmdd_(date?:Date):string
+export {
+	utc_yyyymmdd_ as _utc_yyyymmdd,
+	utc_yyyymmdd_ as _yyyymmdd__utc,
+}

package/all/utc_yyyymmdd/index.js

@@ -0,0 +1,13 @@
+import { pad2 } from '../pad2/index.js'
+/**
+ * @param {Date}[date]
+ * @returns {string}
+ */
+export function utc_yyyymmdd_(date) {
+	date = date || new Date()
+	return date.getUTCFullYear() + pad2(date.getUTCMonth() + 1) + pad2(date.getUTCDate())
+}
+export {
+	utc_yyyymmdd_ as _utc_yyyymmdd,
+	utc_yyyymmdd_ as _yyyymmdd__utc,
+}

package/all/utc_yyyymmddhhmmss/index.d.ts

@@ -0,0 +1,5 @@
+export declare function utc_yyyymmddhhmmss_(date?:Date):string
+export {
+	utc_yyyymmddhhmmss_ as _utc_yyyymmddhhmmss,
+	utc_yyyymmddhhmmss_ as _yyyymmddhhmmss__utc,
+}

package/all/utc_yyyymmddhhmmss/index.js

@@ -0,0 +1,18 @@
+import { pad2 } from '../pad2/index.js'
+import { utc_yyyymmdd_ } from '../utc_yyyymmdd/index.js'
+/**
+ * @param {Date}[date]
+ * @returns {string}
+ */
+export function utc_yyyymmddhhmmss_(date) {
+	date = date || new Date()
+	return (
+		utc_yyyymmdd_(date)
+		+ pad2(date.getUTCHours())
+		+ pad2(date.getUTCMinutes())
+		+ pad2(date.getUTCSeconds()))
+}
+export {
+	utc_yyyymmddhhmmss_ as _utc_yyyymmddhhmmss,
+	utc_yyyymmddhhmmss_ as _yyyymmddhhmmss__utc,
+}

package/all/uuid/index.d.ts

@@ -0,0 +1,5 @@
+export declare function uuid_():string
+export {
+	uuid_ as _uuid,
+	uuid_ as uuid,
+}

package/all/uuid/index.js

@@ -0,0 +1,19 @@
+//https://gist.github.com/LeverOne/1308368
+export function uuid_() {
+	let a = 0, b = ''
+	for (
+		;
+		a++ < 36;
+		b += a * 51 & 52 // if "a" is not 9 or 14 or 19 or 24
+			? (a ^ 15 // if "a" is not 15
+					? 8 ^ Math.random() * (a ^ 20 ? 16 : 4 // unless "a" is 20, in which case a random number from 8 to 11
+				) : 4 //	otherwise 4
+			).toString(16) : '-' //	in other cases (if "a" is 9,14,19,24) insert "-"
+	) {
+	}
+	return b
+}
+export {
+	uuid_ as _uuid,
+	uuid_ as uuid,
+}

package/all/val/index.d.ts

@@ -0,0 +1,4 @@
+export declare function val_<
+	I extends unknown = unknown
+>(val:I):()=>I
+export { val_ as _val, }

package/all/val/index.js

@@ -0,0 +1,8 @@
+/**
+ * @param {unknown}val
+ * @returns {(val:unknown)=>()=>unknown}
+ */
+export function val_(val) {
+	return ()=>val
+}
+export { val_ as _val, }

package/all/value_key_aa/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns Array of `[value, key]` in `obj`
+ */
+export declare function value_key_aa_<
+	I extends object = object
+>(obj:I):[I[keyof I], string][]
+export {
+	value_key_aa_ as value_key_a2_,
+	value_key_aa_ as _a2__key__value,
+}

package/all/value_key_aa/index.js

@@ -0,0 +1,20 @@
+/**
+ * Returns Array of `[value, key]` in `obj`
+ * @param {object}obj
+ * @returns {[string, string][]}
+ * @private
+ */
+export function value_key_aa_(obj) {
+	const value_key_aa = []
+	for (let key in obj) {
+		value_key_aa.push([
+			obj[key],
+			key
+		])
+	}
+	return value_key_aa
+}
+export {
+	value_key_aa_ as value_key_a2_,
+	value_key_aa_ as _a2__key__value,
+}

package/all/value_key_zip_r/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns an Object the key & value are set from the zipped `a_i0` & `a_i1` Array of `[key, value]` pairs.
+ */
+export declare function value_key_zip_r_<
+	K extends (string|number|symbol),
+	V extends unknown
+>(
+	[a_i0, a_i1]:[readonly K[], readonly V[]]
+):Record<K, V>
+export {
+	value_key_zip_r_ as _value_key_zip_hash,
+	value_key_zip_r_ as _hash__zip__key__value,
+}

package/all/value_key_zip_r/index.js

@@ -0,0 +1,20 @@
+import { zip } from '../zip/index.js'
+/**
+ * Returns an Object the key & value are set from the zipped `a_i0` & `a_i1` Array of `[key, value]` pairs.
+ * @param {[(string|number|symbol)[], (string|number|symbol)[]]}aa
+ * @returns {Record<(string|number|symbol)[], (string|number|symbol)[]>}
+ */
+export function value_key_zip_r_(aa) {
+	const [a_i0, a_i1] = aa
+	const value_key_zip_r = {}
+	const value_key_aa = zip([a_i0, a_i1])
+	for (const kv of value_key_aa) {
+		value_key_zip_r[kv[0]] = kv[1]
+	}
+	return value_key_zip_r
+}
+export {
+	value_key_zip_r_ as value_key_zip_h_,
+	value_key_zip_r_ as _value_key_zip_hash,
+	value_key_zip_r_ as _hash__zip__key__value,
+}