@aglyn/shared-util-tools 1.0.0-beta.143

package/src/lib/serialize/json-serialize.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Generates a string with **_JSON_** representation of a value
+ *
+ * @see {@link jsonDeserialize}
+ * @see {@link JSON.parse}
+ * @see {@link JSON.stringify}
+ */
+export declare function jsonSerialize(...args: Parameters<typeof JSON.stringify>): ReturnType<typeof JSON.stringify>;
+export default jsonSerialize;

package/src/lib/serialize/json-serialize.js

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Generates a string with **_JSON_** representation of a value
+ *
+ * @see {@link jsonDeserialize}
+ * @see {@link JSON.parse}
+ * @see {@link JSON.stringify}
+ */ export function jsonSerialize(...args) {
+    return JSON.stringify(...args);
+}
+export default jsonSerialize;
+
+//# sourceMappingURL=json-serialize.js.map

package/src/lib/serialize/json-serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/serialize/json-serialize.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Generates a string with **_JSON_** representation of a value\n *\n * @see {@link jsonDeserialize}\n * @see {@link JSON.parse}\n * @see {@link JSON.stringify}\n */\nexport function jsonSerialize(...args: Parameters<typeof JSON.stringify>): ReturnType<typeof JSON.stringify> {\n  return JSON.stringify(...args)\n}\nexport default jsonSerialize\n"],"names":["jsonSerialize","args","JSON","stringify"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;CAMC,GACD,OAAO,SAASA,cAAc,GAAGC,IAAuC;IACtE,OAAOC,KAAKC,SAAS,IAAIF;AAC3B;AACA,eAAeD,cAAa"}

package/src/lib/serialize/php-serial-deserialize-from-byte-stream.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { unserialize as phpSerialDeserializeFromByteStream } from 'php-serialize';
+/**
+ * Generates a string with **_byte-stream_** representation of a value.
+ *
+ * **Note:**
+ * that this is a binary string which may include null bytes, and needs to be
+ * stored and handled as such. For example, serialize() output should generally
+ * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.
+ *
+ * ---
+ *
+ * @example
+ * export function serialize(
+ *    item: any,
+ *    phpToJsScope: Object = {},
+ *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }
+ *  ): string
+ *
+ * @example
+ * class User {
+ *   constructor({ name, age }) {
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *   serialize() {
+ *     return JSON.stringify({ name: this.name, age: this.age })
+ *   }
+ *   unserialize(rawData) {
+ *     const { name, age } = JSON.parse(rawData)
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *  }
+ *  const steel = new User({ name: 'Steel Brain', age: 17 })
+ *
+ *
+ *  // Serialize to byte stream string
+ *  const serialized = serializeToByteStream(steel)
+ *
+ *  // Serialize User class to given name
+ *  const serializedForNamespace = serializeToByteStream(steel, {
+ *   'MyApp\\User': User,
+ *  })
+ *
+ * @example
+ * // Result: serialized
+ *  "C:4:\"User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ *  // Result: serializedForNamespace
+ *  "C:10:\"MyApp\\User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ * @example
+ * // Result: unserialized
+ * unserialized instanceof User = true
+ *
+ * @see {@link phpSerialIsSerialized}
+ * @see {@link phpSerialSerialize}
+ * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}
+ */
+export { phpSerialDeserializeFromByteStream };
+export default phpSerialDeserializeFromByteStream;

package/src/lib/serialize/php-serial-deserialize-from-byte-stream.js

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { unserialize as phpSerialDeserializeFromByteStream } from "php-serialize";
+/**
+ * Generates a string with **_byte-stream_** representation of a value.
+ *
+ * **Note:**
+ * that this is a binary string which may include null bytes, and needs to be
+ * stored and handled as such. For example, serialize() output should generally
+ * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.
+ *
+ * ---
+ *
+ * @example
+ * export function serialize(
+ *    item: any,
+ *    phpToJsScope: Object = {},
+ *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }
+ *  ): string
+ *
+ * @example
+ * class User {
+ *   constructor({ name, age }) {
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *   serialize() {
+ *     return JSON.stringify({ name: this.name, age: this.age })
+ *   }
+ *   unserialize(rawData) {
+ *     const { name, age } = JSON.parse(rawData)
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *  }
+ *  const steel = new User({ name: 'Steel Brain', age: 17 })
+ *
+ *
+ *  // Serialize to byte stream string
+ *  const serialized = serializeToByteStream(steel)
+ *
+ *  // Serialize User class to given name
+ *  const serializedForNamespace = serializeToByteStream(steel, {
+ *   'MyApp\\User': User,
+ *  })
+ *
+ * @example
+ * // Result: serialized
+ *  "C:4:\"User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ *  // Result: serializedForNamespace
+ *  "C:10:\"MyApp\\User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ * @example
+ * // Result: unserialized
+ * unserialized instanceof User = true
+ *
+ * @see {@link phpSerialIsSerialized}
+ * @see {@link phpSerialSerialize}
+ * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}
+ */ export { phpSerialDeserializeFromByteStream };
+export default phpSerialDeserializeFromByteStream;
+
+//# sourceMappingURL=php-serial-deserialize-from-byte-stream.js.map

package/src/lib/serialize/php-serial-deserialize-from-byte-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/serialize/php-serial-deserialize-from-byte-stream.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {unserialize as phpSerialDeserializeFromByteStream} from 'php-serialize'\n\n\n/**\n * Generates a string with **_byte-stream_** representation of a value.\n *\n * **Note:**\n * that this is a binary string which may include null bytes, and needs to be\n * stored and handled as such. For example, serialize() output should generally\n * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.\n *\n * ---\n *\n * @example\n * export function serialize(\n *    item: any,\n *    phpToJsScope: Object = {},\n *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }\n *  ): string\n *\n * @example\n * class User {\n *   constructor({ name, age }) {\n *     this.name = name\n *     this.age = age\n *   }\n *   serialize() {\n *     return JSON.stringify({ name: this.name, age: this.age })\n *   }\n *   unserialize(rawData) {\n *     const { name, age } = JSON.parse(rawData)\n *     this.name = name\n *     this.age = age\n *   }\n *  }\n *  const steel = new User({ name: 'Steel Brain', age: 17 })\n *\n *\n *  // Serialize to byte stream string\n *  const serialized = serializeToByteStream(steel)\n *\n *  // Serialize User class to given name\n *  const serializedForNamespace = serializeToByteStream(steel, {\n *   'MyApp\\\\User': User,\n *  })\n *\n * @example\n * // Result: serialized\n *  \"C:4:\\\"User\\\":31:{{\\\"name\\\":\\\"Steel Brain\\\",\\\"age\\\":17}}\"\n *\n *  // Result: serializedForNamespace\n *  \"C:10:\\\"MyApp\\\\User\\\":31:{{\\\"name\\\":\\\"Steel Brain\\\",\\\"age\\\":17}}\"\n *\n * @example\n * // Result: unserialized\n * unserialized instanceof User = true\n *\n * @see {@link phpSerialIsSerialized}\n * @see {@link phpSerialSerialize}\n * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}\n */\nexport {phpSerialDeserializeFromByteStream}\nexport default phpSerialDeserializeFromByteStream\n"],"names":["unserialize","phpSerialDeserializeFromByteStream"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAAQA,eAAeC,kCAAkC,QAAO,gBAAe;AAG/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDC,GACD,SAAQA,kCAAkC,GAAC;AAC3C,eAAeA,mCAAkC"}

package/src/lib/serialize/php-serial-is-serialized-byte-stream.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { isSerialized as phpSerialIsSerializedByteStream } from 'php-serialize';
+/**
+ * Generates a string with **_byte-stream_** representation of a value.
+ *
+ * **Note:**
+ * that this is a binary string which may include null bytes, and needs to be
+ * stored and handled as such. For example, serialize() output should generally
+ * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.
+ *
+ * ---
+ *
+ * @example
+ * export function serialize(
+ *    item: any,
+ *    phpToJsScope: Object = {},
+ *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }
+ *  ): string
+ *
+ * @example
+ * class User {
+ *   constructor({ name, age }) {
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *   serialize() {
+ *     return JSON.stringify({ name: this.name, age: this.age })
+ *   }
+ *   unserialize(rawData) {
+ *     const { name, age } = JSON.parse(rawData)
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *  }
+ *  const steel = new User({ name: 'Steel Brain', age: 17 })
+ *
+ *
+ *  // Serialize to byte stream string
+ *  const serialized = serializeToByteStream(steel)
+ *
+ *  // Serialize User class to given name
+ *  const serializedForNamespace = serializeToByteStream(steel, {
+ *   'MyApp\\User': User,
+ *  })
+ *
+ * @example
+ * // Result: serialized
+ *  "C:4:\"User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ *  // Result: serializedForNamespace
+ *  "C:10:\"MyApp\\User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ * @example
+ * // Result: unserialized
+ * unserialized instanceof User = true
+ *
+ * @see {@link phpSerialIsSerialized}
+ * @see {@link phpSerialSerialize}
+ * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}
+ */
+export { phpSerialIsSerializedByteStream };
+export default phpSerialIsSerializedByteStream;

package/src/lib/serialize/php-serial-is-serialized-byte-stream.js

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { isSerialized as phpSerialIsSerializedByteStream } from "php-serialize";
+/**
+ * Generates a string with **_byte-stream_** representation of a value.
+ *
+ * **Note:**
+ * that this is a binary string which may include null bytes, and needs to be
+ * stored and handled as such. For example, serialize() output should generally
+ * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.
+ *
+ * ---
+ *
+ * @example
+ * export function serialize(
+ *    item: any,
+ *    phpToJsScope: Object = {},
+ *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }
+ *  ): string
+ *
+ * @example
+ * class User {
+ *   constructor({ name, age }) {
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *   serialize() {
+ *     return JSON.stringify({ name: this.name, age: this.age })
+ *   }
+ *   unserialize(rawData) {
+ *     const { name, age } = JSON.parse(rawData)
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *  }
+ *  const steel = new User({ name: 'Steel Brain', age: 17 })
+ *
+ *
+ *  // Serialize to byte stream string
+ *  const serialized = serializeToByteStream(steel)
+ *
+ *  // Serialize User class to given name
+ *  const serializedForNamespace = serializeToByteStream(steel, {
+ *   'MyApp\\User': User,
+ *  })
+ *
+ * @example
+ * // Result: serialized
+ *  "C:4:\"User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ *  // Result: serializedForNamespace
+ *  "C:10:\"MyApp\\User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ * @example
+ * // Result: unserialized
+ * unserialized instanceof User = true
+ *
+ * @see {@link phpSerialIsSerialized}
+ * @see {@link phpSerialSerialize}
+ * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}
+ */ export { phpSerialIsSerializedByteStream };
+export default phpSerialIsSerializedByteStream;
+
+//# sourceMappingURL=php-serial-is-serialized-byte-stream.js.map

package/src/lib/serialize/php-serial-is-serialized-byte-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/serialize/php-serial-is-serialized-byte-stream.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {isSerialized as phpSerialIsSerializedByteStream} from 'php-serialize'\n\n\n/**\n * Generates a string with **_byte-stream_** representation of a value.\n *\n * **Note:**\n * that this is a binary string which may include null bytes, and needs to be\n * stored and handled as such. For example, serialize() output should generally\n * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.\n *\n * ---\n *\n * @example\n * export function serialize(\n *    item: any,\n *    phpToJsScope: Object = {},\n *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }\n *  ): string\n *\n * @example\n * class User {\n *   constructor({ name, age }) {\n *     this.name = name\n *     this.age = age\n *   }\n *   serialize() {\n *     return JSON.stringify({ name: this.name, age: this.age })\n *   }\n *   unserialize(rawData) {\n *     const { name, age } = JSON.parse(rawData)\n *     this.name = name\n *     this.age = age\n *   }\n *  }\n *  const steel = new User({ name: 'Steel Brain', age: 17 })\n *\n *\n *  // Serialize to byte stream string\n *  const serialized = serializeToByteStream(steel)\n *\n *  // Serialize User class to given name\n *  const serializedForNamespace = serializeToByteStream(steel, {\n *   'MyApp\\\\User': User,\n *  })\n *\n * @example\n * // Result: serialized\n *  \"C:4:\\\"User\\\":31:{{\\\"name\\\":\\\"Steel Brain\\\",\\\"age\\\":17}}\"\n *\n *  // Result: serializedForNamespace\n *  \"C:10:\\\"MyApp\\\\User\\\":31:{{\\\"name\\\":\\\"Steel Brain\\\",\\\"age\\\":17}}\"\n *\n * @example\n * // Result: unserialized\n * unserialized instanceof User = true\n *\n * @see {@link phpSerialIsSerialized}\n * @see {@link phpSerialSerialize}\n * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}\n */\nexport {phpSerialIsSerializedByteStream}\nexport default phpSerialIsSerializedByteStream\n"],"names":["isSerialized","phpSerialIsSerializedByteStream"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAAQA,gBAAgBC,+BAA+B,QAAO,gBAAe;AAG7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDC,GACD,SAAQA,+BAA+B,GAAC;AACxC,eAAeA,gCAA+B"}

package/src/lib/serialize/php-serial-serialize-to-byte-stream.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { serialize as phpSerialSerializeToByteStream } from 'php-serialize';
+/**
+ * Generates a string with **_byte-stream_** representation of a value.
+ *
+ * **Note:**
+ * that this is a binary string which may include null bytes, and needs to be
+ * stored and handled as such. For example, serialize() output should generally
+ * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.
+ *
+ * ---
+ *
+ * @example
+ * export function serialize(
+ *    item: any,
+ *    phpToJsScope: Object = {},
+ *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }
+ *  ): string
+ *
+ * @example
+ * class User {
+ *   constructor({ name, age }) {
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *   serialize() {
+ *     return JSON.stringify({ name: this.name, age: this.age })
+ *   }
+ *   unserialize(rawData) {
+ *     const { name, age } = JSON.parse(rawData)
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *  }
+ *  const steel = new User({ name: 'Steel Brain', age: 17 })
+ *
+ *
+ *  // Serialize to byte stream string
+ *  const serialized = serializeToByteStream(steel)
+ *
+ *  // Serialize User class to given name
+ *  const serializedForNamespace = serializeToByteStream(steel, {
+ *   'MyApp\\User': User,
+ *  })
+ *
+ * @example
+ * // Result: serialized
+ *  "C:4:\"User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ *  // Result: serializedForNamespace
+ *  "C:10:\"MyApp\\User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ * @example
+ * // Result: unserialized
+ * unserialized instanceof User = true
+ *
+ * @see {@link phpSerialIsSerialized}
+ * @see {@link phpSerialSerialize}
+ * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}
+ */
+export { phpSerialSerializeToByteStream };
+export default phpSerialSerializeToByteStream;

package/src/lib/serialize/php-serial-serialize-to-byte-stream.js

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { serialize as phpSerialSerializeToByteStream } from "php-serialize";
+/**
+ * Generates a string with **_byte-stream_** representation of a value.
+ *
+ * **Note:**
+ * that this is a binary string which may include null bytes, and needs to be
+ * stored and handled as such. For example, serialize() output should generally
+ * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.
+ *
+ * ---
+ *
+ * @example
+ * export function serialize(
+ *    item: any,
+ *    phpToJsScope: Object = {},
+ *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }
+ *  ): string
+ *
+ * @example
+ * class User {
+ *   constructor({ name, age }) {
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *   serialize() {
+ *     return JSON.stringify({ name: this.name, age: this.age })
+ *   }
+ *   unserialize(rawData) {
+ *     const { name, age } = JSON.parse(rawData)
+ *     this.name = name
+ *     this.age = age
+ *   }
+ *  }
+ *  const steel = new User({ name: 'Steel Brain', age: 17 })
+ *
+ *
+ *  // Serialize to byte stream string
+ *  const serialized = serializeToByteStream(steel)
+ *
+ *  // Serialize User class to given name
+ *  const serializedForNamespace = serializeToByteStream(steel, {
+ *   'MyApp\\User': User,
+ *  })
+ *
+ * @example
+ * // Result: serialized
+ *  "C:4:\"User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ *  // Result: serializedForNamespace
+ *  "C:10:\"MyApp\\User\":31:{{\"name\":\"Steel Brain\",\"age\":17}}"
+ *
+ * @example
+ * // Result: unserialized
+ * unserialized instanceof User = true
+ *
+ * @see {@link phpSerialIsSerialized}
+ * @see {@link phpSerialSerialize}
+ * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}
+ */ export { phpSerialSerializeToByteStream };
+export default phpSerialSerializeToByteStream;
+
+//# sourceMappingURL=php-serial-serialize-to-byte-stream.js.map

package/src/lib/serialize/php-serial-serialize-to-byte-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/serialize/php-serial-serialize-to-byte-stream.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {serialize as phpSerialSerializeToByteStream} from 'php-serialize'\n\n\n/**\n * Generates a string with **_byte-stream_** representation of a value.\n *\n * **Note:**\n * that this is a binary string which may include null bytes, and needs to be\n * stored and handled as such. For example, serialize() output should generally\n * be stored in a BLOB field in a database, rather than a CHAR or TEXT field.\n *\n * ---\n *\n * @example\n * export function serialize(\n *    item: any,\n *    phpToJsScope: Object = {},\n *    options: { encoding: 'utf8' | 'binary' } = { encoding: 'utf8' }\n *  ): string\n *\n * @example\n * class User {\n *   constructor({ name, age }) {\n *     this.name = name\n *     this.age = age\n *   }\n *   serialize() {\n *     return JSON.stringify({ name: this.name, age: this.age })\n *   }\n *   unserialize(rawData) {\n *     const { name, age } = JSON.parse(rawData)\n *     this.name = name\n *     this.age = age\n *   }\n *  }\n *  const steel = new User({ name: 'Steel Brain', age: 17 })\n *\n *\n *  // Serialize to byte stream string\n *  const serialized = serializeToByteStream(steel)\n *\n *  // Serialize User class to given name\n *  const serializedForNamespace = serializeToByteStream(steel, {\n *   'MyApp\\\\User': User,\n *  })\n *\n * @example\n * // Result: serialized\n *  \"C:4:\\\"User\\\":31:{{\\\"name\\\":\\\"Steel Brain\\\",\\\"age\\\":17}}\"\n *\n *  // Result: serializedForNamespace\n *  \"C:10:\\\"MyApp\\\\User\\\":31:{{\\\"name\\\":\\\"Steel Brain\\\",\\\"age\\\":17}}\"\n *\n * @example\n * // Result: unserialized\n * unserialized instanceof User = true\n *\n * @see {@link phpSerialIsSerialized}\n * @see {@link phpSerialSerialize}\n * @see {@link https://github.com/steelbrain/php-serialize|PHP Serializer}\n */\nexport {phpSerialSerializeToByteStream}\nexport default phpSerialSerializeToByteStream\n"],"names":["serialize","phpSerialSerializeToByteStream"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAAQA,aAAaC,8BAA8B,QAAO,gBAAe;AAGzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDC,GACD,SAAQA,8BAA8B,GAAC;AACvC,eAAeA,+BAA8B"}

package/src/lib/split-display-name.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export interface SplitDisplayName {
+    firstName: string;
+    lastName: string;
+}
+/**
+ * A single `displayName` split into the first/last pair the console profile
+ * stores (AGL-1127). Identity providers hand us one string — Google and a
+ * SAML assertion both do — while `users/{uid}` and the Basic info form are
+ * two fields, so seeding a profile from a provider needs a split.
+ *
+ * Everything after the first space is the last name, so multi-word family
+ * names ("Ada Lovelace King") survive intact. A single word is a first name
+ * with no last name rather than a guess, and an empty/absent value yields two
+ * empty strings — the caller decides whether that is worth writing.
+ *
+ * Deliberately naive: this is a SEED for a form the user can edit, not an
+ * attempt to parse names correctly, which is not something a splitter can do.
+ */
+export declare function splitDisplayName(displayName?: string | null): SplitDisplayName;
+export default splitDisplayName;

package/src/lib/split-display-name.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * A single `displayName` split into the first/last pair the console profile
+ * stores (AGL-1127). Identity providers hand us one string — Google and a
+ * SAML assertion both do — while `users/{uid}` and the Basic info form are
+ * two fields, so seeding a profile from a provider needs a split.
+ *
+ * Everything after the first space is the last name, so multi-word family
+ * names ("Ada Lovelace King") survive intact. A single word is a first name
+ * with no last name rather than a guess, and an empty/absent value yields two
+ * empty strings — the caller decides whether that is worth writing.
+ *
+ * Deliberately naive: this is a SEED for a form the user can edit, not an
+ * attempt to parse names correctly, which is not something a splitter can do.
+ */ export function splitDisplayName(displayName) {
+    const cleaned = String(displayName != null ? displayName : '').replace(/\s+/g, ' ').trim();
+    if (!cleaned) return {
+        firstName: '',
+        lastName: ''
+    };
+    const boundary = cleaned.indexOf(' ');
+    if (boundary === -1) return {
+        firstName: cleaned,
+        lastName: ''
+    };
+    return {
+        firstName: cleaned.slice(0, boundary),
+        lastName: cleaned.slice(boundary + 1)
+    };
+}
+export default splitDisplayName;
+
+//# sourceMappingURL=split-display-name.js.map

package/src/lib/split-display-name.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/split-display-name.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport interface SplitDisplayName {\n  firstName: string\n  lastName: string\n}\n\n/**\n * A single `displayName` split into the first/last pair the console profile\n * stores (AGL-1127). Identity providers hand us one string — Google and a\n * SAML assertion both do — while `users/{uid}` and the Basic info form are\n * two fields, so seeding a profile from a provider needs a split.\n *\n * Everything after the first space is the last name, so multi-word family\n * names (\"Ada Lovelace King\") survive intact. A single word is a first name\n * with no last name rather than a guess, and an empty/absent value yields two\n * empty strings — the caller decides whether that is worth writing.\n *\n * Deliberately naive: this is a SEED for a form the user can edit, not an\n * attempt to parse names correctly, which is not something a splitter can do.\n */\nexport function splitDisplayName(\n  displayName?: string | null,\n): SplitDisplayName {\n  const cleaned = String(displayName ?? '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n  if (!cleaned) return { firstName: '', lastName: '' }\n  const boundary = cleaned.indexOf(' ')\n  if (boundary === -1) return { firstName: cleaned, lastName: '' }\n  return {\n    firstName: cleaned.slice(0, boundary),\n    lastName: cleaned.slice(boundary + 1),\n  }\n}\n\nexport default splitDisplayName\n"],"names":["splitDisplayName","displayName","cleaned","String","replace","trim","firstName","lastName","boundary","indexOf","slice"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAOD;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASA,iBACdC,WAA2B;IAE3B,MAAMC,UAAUC,OAAOF,sBAAAA,cAAe,IACnCG,OAAO,CAAC,QAAQ,KAChBC,IAAI;IACP,IAAI,CAACH,SAAS,OAAO;QAAEI,WAAW;QAAIC,UAAU;IAAG;IACnD,MAAMC,WAAWN,QAAQO,OAAO,CAAC;IACjC,IAAID,aAAa,CAAC,GAAG,OAAO;QAAEF,WAAWJ;QAASK,UAAU;IAAG;IAC/D,OAAO;QACLD,WAAWJ,QAAQQ,KAAK,CAAC,GAAGF;QAC5BD,UAAUL,QAAQQ,KAAK,CAACF,WAAW;IACrC;AACF;AAEA,eAAeR,iBAAgB"}

package/src/lib/str.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Shortcut for spreading multiple strings String(...)
+ */
+export declare function str(...val: any[]): string;
+export default str;