@yurkimus/cookies 0.0.0

package/deno.json

@@ -0,0 +1,12 @@
+{
+  "name": "@yurkimus/cookies",
+  "version": "0.0.0",
+  "fmt": {
+    "semiColons": false,
+    "singleQuote": true
+  },
+  "exports": "./source/index.js",
+  "imports": {
+    "@yurkimus/curry": "https://raw.githubusercontent.com/yurkimus/curry/main/source/index.js"
+  }
+}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "type": "module",
+  "version": "0.0.0",
+  "name": "@yurkimus/cookies",
+  "author": {
+    "name": "yurkimus",
+    "email": "yurkimus@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yurkimus/cookies.git"
+  },
+  "exports": "./source/index.js",
+  "dependencies": {
+    "@yurkimus/types": "@yurkimus/types"
+  }
+}

package/readme.md

@@ -0,0 +1,59 @@
+# Cookies
+
+A collection of utilities for handling cookies in JavaScript.
+
+## parseCookie
+
+Parses a cookie string into a list of key-value pairs.
+
+| Parameter | Type     | Description   |
+| --------- | -------- | ------------- |
+| cookie    | `string` | Cookie string |
+
+**Returns**: `[string, string][]`
+
+**Example**:
+
+```javascript
+parseCookie('name=John; age=30; role=admin') // => [['name', 'John'], ['age', '30'], ['role', 'admin']]
+```
+
+## readCookie
+
+Reads cookies from a cookie string using a provided list of keys.
+
+| Parameter | Type                   | Description                  |
+| --------- | ---------------------- | ---------------------------- |
+| keys      | `string` or `string[]` | List of keys or a single key |
+| cookie    | `string`               | Cookie string                |
+
+**Example**:
+
+```javascript
+let cookie = 'name=John; age=30; role=admin'
+
+readCookie('age', cookie) // => '30'
+
+readCookie(['age', 'name'], cookie) // => ['30', 'John']
+```
+
+## serializeCookie
+
+Serializes a cookie from its components into a string.
+
+| Parameter  | Type                 | Description                                              |
+| ---------- | -------------------- | -------------------------------------------------------- |
+| name       | `string`             | The name of the cookie                                   |
+| value      | `string`             | The value of the cookie                                  |
+| attributes | `[string, string][]` | An array containing additional attributes for the cookie |
+
+**Example**:
+
+```javascript
+let attributes = [
+  ['path', '/'],
+  ['expires', 'Wed, 21 Oct 2026 07:28:00 GMT'],
+]
+
+serializeCookie('name', 'John', attributes) // => 'name=John; path=/; expires=Wed, 21 Oct 2026 07:28:00 GMT'
+```

package/source/index.js

@@ -0,0 +1,75 @@
+import { is, isLike } from '@yurkimus/types'
+
+/**
+ * Parses a cookie string into a list of key-value pairs.
+ *
+ * @param {string} cookie
+ *
+ * @returns {[string, string][]}
+ *
+ * @example
+ * ```
+ * let  cookie = 'name=John; age=30; role=admin',
+ *      parsed = parseCookie(cookieString); // => [string, string][]
+ * ```
+ */
+export var parseCookie = (cookie) => {
+  if (!is('String', cookie)) {
+    throw new TypeError('"cookie" must be a string!')
+  }
+
+  return cookie.split('; ').map((string) => string.split('='))
+}
+
+/**
+ * Reads cookies from a cookie string using a provided list of keys.
+ *
+ * @param {string | string[]} keys
+ * @param {string} cookie
+ *
+ * @returns {string | string[]}
+ *
+ * @example
+ * ```
+ * let  cookie = 'name=John; age=30; role=admin',
+ *      cookies1 = readCookie('age', cookie); // => '30'
+ *      cookies2 = readCookie(['age', 'name'], cookie); // => ['30', 'John']
+ * ```
+ */
+export var readCookie = (keys, cookie) => {
+  if (!is('String', cookie)) {
+    throw new TypeError('"cookie" must be a String!')
+  }
+
+  var cookies = Object.fromEntries(parseCookie(cookie))
+
+  if (isLike('Array')) {
+    return Array.prototype.map.call(keys, (key) => cookies[key])
+  }
+
+  return cookies[keys]
+}
+
+/**
+ * Serializes a cookie from its components into a string.
+ *
+ * @param {string} name The name of the cookie.
+ * @param {string} value The value of the cookie.
+ * @param {[string, string][]} attributes An array containing additional attributes for the cookie.
+ *
+ * @example
+ * ```
+ * let  name = 'name',
+ *      value = 'John',
+ *      attributes = [['path', '/'], ['expires', 'Wed, 21 Oct 2026 07:28:00 GMT']],
+ *      serialized = serializeCookie(name, value, attributes); // => 'name=John; path=/; expires=Wed, 21 Oct 2026 07:28:00 GMT'
+ * ```
+ */
+export var serializeCookie = (name, value, attributes) =>
+  name +
+  '=' +
+  value +
+  attributes.reduce(
+    (string, attribute) => string + '; ' + attribute.join('='),
+    '',
+  )