sliftutils 1.0.4 → 1.1.1

package/.cursorrules

@@ -29,6 +29,8 @@ The code automatically updates on save, so do not ever run commands to rerun the
 Use tool calls to read files and directories where possible, instead of running "ls", "dir", etc.
 
 Coding Styles
+    Times should almost always be in milliseconds, and if not told, you should assume a time is in milliseconds.
+
     Don't make functions that will never be reused and are short. This just makes the code too confusing. If the function is under five lines and it's not being reused, you shouldn't create it, unless instructed explicitly to create it.
 
     Comments should be used sparingly and only if it's required to explain what's being done. If you're calling a function called create imageName and the comment is called create imageName, you will be fired because that's just stupid. It's a waste of lines. 
@@ -191,7 +193,7 @@ css
 
 However, there are some helper functions that will directly map to commonly used styles. 
 
-    If you want to make a NON-Button feel like a button, you can use "css.button", which makes the background color change on hover, and make the cursor a pointer. Only use this if the background color is set, otherwise you need to message it's a button in another way. And never use it for <Button> which already does this.
+    If you want to make a NON-Button feel like a button, you can use "css.button", which makes the background color change on hover, and make the cursor a pointer. Only use this if the background color is set, otherwise you need to message it's a button in another way. And never use it for <Button>/<button> which already does this.
 
     Generally use hbox/vbox to set the spacing between elements, instead of using margins.
 

package/.gitignore

@@ -28,6 +28,7 @@ data
 *.gif
 *.bmp
 *.tiff
+*.cert
 temp
 yarn-error.log
 pretrained_models

package/index.d.ts

@@ -62,6 +62,149 @@ declare module "sliftutils/misc/helpers" {
 
 }
 
+declare module "sliftutils/misc/https/certs" {
+    /// <reference path="node-forge-ed25519.d.ts" />
+    /// <reference path="../../storage/storage.d.ts" />
+    /// <reference types="node" />
+    /// <reference types="node" />
+    import * as forge from "node-forge";
+    import { MaybePromise } from "socket-function/src/types";
+    export declare const CA_NOT_FOUND_ERROR = "18aa7318-f88f-4d2d-b41f-3daf4a433827";
+    export declare const identityStorageKey = "machineCA_10";
+    export type IdentityStorageType = {
+        domain: string;
+        certB64: string;
+        keyB64: string;
+    };
+    export interface X509KeyPair {
+        domain: string;
+        cert: Buffer;
+        key: Buffer;
+    }
+    export declare function getCommonName(cert: Buffer | string): string;
+    export declare function createX509(config: {
+        domain: string;
+        issuer: X509KeyPair | "self";
+        lifeSpan: number;
+        keyPair: {
+            publicKey: forge.Ed25519PublicKey;
+            privateKey: forge.Ed25519PrivateKey;
+        } | forge.pki.KeyPair;
+    }): X509KeyPair;
+    export declare function privateKeyToPem(buffer: forge.pki.PrivateKey | forge.Ed25519PrivateKey): string;
+    export declare function parseCert(PEMorDER: string | Buffer): forge.pki.Certificate;
+    export declare function getPublicIdentifier(PEMorDER: string | Buffer): Buffer;
+    export declare const sign: (keyPair: {
+        key: string | Buffer;
+    }, data: unknown) => string;
+    export declare function verify(cert: string, signature: string, data: unknown): boolean;
+    export declare function validateCACert(domain: string, cert: string | Buffer): void;
+    export declare function validateCertificate(domain: string, cert: Buffer | string, issuerCert: Buffer | string): void;
+    export declare function generateKeyPair(): forge.pki.rsa.KeyPair;
+    export declare function generateRSAKeyPair(): forge.pki.rsa.KeyPair;
+    export declare function generateTestCA(domain: string): X509KeyPair;
+    export declare function createCertFromCA(config: {
+        CAKeyPair: X509KeyPair;
+    }): X509KeyPair;
+    export declare function getMachineId(domainName: string): string;
+    export type NodeIdParts = {
+        threadId: string;
+        machineId: string;
+        domain: string;
+        port: number;
+    };
+    export declare function decodeNodeId(nodeId: string): NodeIdParts | undefined;
+    export declare function decodeNodeIdAssert(nodeId: string): NodeIdParts;
+    export declare function encodeNodeId(parts: NodeIdParts): string;
+    export declare function setIdentityCARaw(domain: string, json: string): Promise<void>;
+    export declare function loadIdentityCA(domain: string): Promise<void>;
+    export declare function getIdentityCA(domain: string): X509KeyPair;
+    export declare function getIdentityCAPromise(domain: string): MaybePromise<X509KeyPair>;
+    export declare function getOwnMachineId(domain: string): string;
+    /** Part of the machineId comes from the publicKey, so we can use it to verify */
+    export declare function verifyMachineIdForPublicKey(config: {
+        machineId: string;
+        publicKey: Buffer;
+    }): boolean;
+    export declare function getThreadKeyCert(domain: string): X509KeyPair;
+    export declare const createTestBrowserKeyCert: {
+        (): Promise<X509KeyPair>;
+        reset(): void;
+        set(newValue: Promise<X509KeyPair>): void;
+    };
+    export declare function getOwnNodeId(): string;
+    export declare function getOwnNodeIdAllowUndefined(): string;
+
+}
+
+declare module "sliftutils/misc/https/dns" {
+    export declare function getRecordsRaw(type: string, key: string): Promise<{
+        id: string;
+        type: string;
+        name: string;
+        content: string;
+        proxied: boolean;
+    }[]>;
+    export declare function getRecords(type: string, key: string): Promise<string[]>;
+    export declare function deleteRecord(type: string, key: string, value: string): Promise<void>;
+    /** Removes all existing records (unless the record is already present) */
+    export declare function setRecord(type: string, key: string, value: string, proxied?: "proxied"): Promise<void>;
+    /** Keeps existing records */
+    export declare function addRecord(type: string, key: string, value: string, proxied?: "proxied"): Promise<void>;
+
+}
+
+declare module "sliftutils/misc/https/httpsCerts" {
+    /** NOTE: We also generate the domain *.domain */
+    export declare const getHTTPSCert: {
+        (key: string): Promise<{
+            key: string;
+            cert: string;
+        }>;
+        clear(key: string): void;
+        clearAll(): void;
+        forceSet(key: string, value: Promise<{
+            key: string;
+            cert: string;
+        }>): void;
+        getAllKeys(): string[];
+        get(key: string): Promise<{
+            key: string;
+            cert: string;
+        }> | undefined;
+    };
+
+}
+
+declare module "sliftutils/misc/https/node-forge-ed25519" {
+
+
+    declare module "node-forge" {
+        declare type Ed25519PublicKey = {
+            publicKeyBytes: Buffer;
+        } & Buffer;
+        declare type Ed25519PrivateKey = {
+            privateKeyBytes: Buffer;
+        } & Buffer;
+        class ed25519 {
+            static generateKeyPair(): { publicKey: Ed25519PublicKey, privateKey: Ed25519PrivateKey };
+            static privateKeyToPem(key: Ed25519PrivateKey): string;
+            static privateKeyFromPem(pem: string): Ed25519PrivateKey;
+            static publicKeyToPem(key: Ed25519PublicKey): string;
+            static publicKeyFromPem(pem: string): Ed25519PublicKey;
+        }
+    }
+}
+
+declare module "sliftutils/misc/https/persistentLocalStorage" {
+    import { MaybePromise } from "socket-function/src/types";
+    export declare function getKeyStore<T>(appName: string, key: string): {
+        get(): MaybePromise<T | undefined>;
+        set(value: T | null): MaybePromise<void>;
+    };
+
+}
+
 declare module "sliftutils/misc/matchFilter" {
     export declare function matchFilter(filter: {
         value: string;

package/misc/https/certs.d.ts

@@ -0,0 +1,71 @@
+/// <reference path="node-forge-ed25519.d.ts" />
+/// <reference path="../../storage/storage.d.ts" />
+/// <reference types="node" />
+/// <reference types="node" />
+import * as forge from "node-forge";
+import { MaybePromise } from "socket-function/src/types";
+export declare const CA_NOT_FOUND_ERROR = "18aa7318-f88f-4d2d-b41f-3daf4a433827";
+export declare const identityStorageKey = "machineCA_10";
+export type IdentityStorageType = {
+    domain: string;
+    certB64: string;
+    keyB64: string;
+};
+export interface X509KeyPair {
+    domain: string;
+    cert: Buffer;
+    key: Buffer;
+}
+export declare function getCommonName(cert: Buffer | string): string;
+export declare function createX509(config: {
+    domain: string;
+    issuer: X509KeyPair | "self";
+    lifeSpan: number;
+    keyPair: {
+        publicKey: forge.Ed25519PublicKey;
+        privateKey: forge.Ed25519PrivateKey;
+    } | forge.pki.KeyPair;
+}): X509KeyPair;
+export declare function privateKeyToPem(buffer: forge.pki.PrivateKey | forge.Ed25519PrivateKey): string;
+export declare function parseCert(PEMorDER: string | Buffer): forge.pki.Certificate;
+export declare function getPublicIdentifier(PEMorDER: string | Buffer): Buffer;
+export declare const sign: (keyPair: {
+    key: string | Buffer;
+}, data: unknown) => string;
+export declare function verify(cert: string, signature: string, data: unknown): boolean;
+export declare function validateCACert(domain: string, cert: string | Buffer): void;
+export declare function validateCertificate(domain: string, cert: Buffer | string, issuerCert: Buffer | string): void;
+export declare function generateKeyPair(): forge.pki.rsa.KeyPair;
+export declare function generateRSAKeyPair(): forge.pki.rsa.KeyPair;
+export declare function generateTestCA(domain: string): X509KeyPair;
+export declare function createCertFromCA(config: {
+    CAKeyPair: X509KeyPair;
+}): X509KeyPair;
+export declare function getMachineId(domainName: string): string;
+export type NodeIdParts = {
+    threadId: string;
+    machineId: string;
+    domain: string;
+    port: number;
+};
+export declare function decodeNodeId(nodeId: string): NodeIdParts | undefined;
+export declare function decodeNodeIdAssert(nodeId: string): NodeIdParts;
+export declare function encodeNodeId(parts: NodeIdParts): string;
+export declare function setIdentityCARaw(domain: string, json: string): Promise<void>;
+export declare function loadIdentityCA(domain: string): Promise<void>;
+export declare function getIdentityCA(domain: string): X509KeyPair;
+export declare function getIdentityCAPromise(domain: string): MaybePromise<X509KeyPair>;
+export declare function getOwnMachineId(domain: string): string;
+/** Part of the machineId comes from the publicKey, so we can use it to verify */
+export declare function verifyMachineIdForPublicKey(config: {
+    machineId: string;
+    publicKey: Buffer;
+}): boolean;
+export declare function getThreadKeyCert(domain: string): X509KeyPair;
+export declare const createTestBrowserKeyCert: {
+    (): Promise<X509KeyPair>;
+    reset(): void;
+    set(newValue: Promise<X509KeyPair>): void;
+};
+export declare function getOwnNodeId(): string;
+export declare function getOwnNodeIdAllowUndefined(): string;