@stackframe/stack-shared 1.0.0

package/dist/utils/stores.js

@@ -0,0 +1,122 @@
+import { AsyncResult } from "./results";
+import { generateUuid } from "./uuids";
+import { rejected, resolved } from "./promises";
+export class AsyncStore {
+    _isAvailable;
+    _value = undefined;
+    _isRejected = false;
+    _rejectionError;
+    _waitingRejectFunctions = new Map();
+    _callbacks = new Map();
+    _updateCounter = 0;
+    _lastSuccessfulUpdate = -1;
+    constructor(...args) {
+        if (args.length === 0) {
+            this._isAvailable = false;
+        }
+        else {
+            this._isAvailable = true;
+            this._value = args[0];
+        }
+    }
+    isAvailable() {
+        return this._isAvailable;
+    }
+    isRejected() {
+        return this._isRejected;
+    }
+    get() {
+        if (this.isRejected()) {
+            return AsyncResult.error(this._rejectionError);
+        }
+        else if (this.isAvailable()) {
+            return AsyncResult.ok(this._value);
+        }
+        else {
+            return AsyncResult.pending();
+        }
+    }
+    getOrWait() {
+        const uuid = generateUuid();
+        if (this.isRejected()) {
+            return rejected(this._rejectionError);
+        }
+        else if (this.isAvailable()) {
+            return resolved(this._value);
+        }
+        const promise = new Promise((resolve, reject) => {
+            this.onceChange((value) => {
+                resolve(value);
+            });
+            this._waitingRejectFunctions.set(uuid, reject);
+        });
+        const withFinally = promise.finally(() => {
+            this._waitingRejectFunctions.delete(uuid);
+        });
+        return Object.assign(withFinally, {
+            status: "pending",
+        });
+    }
+    _setIfLatest(value, curCounter) {
+        if (!this._isAvailable || this._isRejected || this._value !== value) {
+            const oldValue = this._value;
+            if (curCounter > this._lastSuccessfulUpdate) {
+                this._lastSuccessfulUpdate = curCounter;
+                this._isAvailable = true;
+                this._isRejected = false;
+                this._value = value;
+                this._callbacks.forEach((callback) => callback(value, oldValue));
+                return true;
+            }
+            return false;
+        }
+        return false;
+    }
+    set(value) {
+        this._setIfLatest(value, ++this._updateCounter);
+    }
+    update(updater) {
+        const value = updater(this._value);
+        this.set(value);
+        return value;
+    }
+    async setAsync(promise) {
+        const curCounter = ++this._updateCounter;
+        const value = await promise;
+        return this._setIfLatest(value, curCounter);
+    }
+    setUnavailable() {
+        this._isAvailable = false;
+        this._isRejected = false;
+        this._value = undefined;
+    }
+    setRejected(error) {
+        this._isRejected = true;
+        this._value = undefined;
+        this._rejectionError = error;
+        this._waitingRejectFunctions.forEach((reject) => reject(error));
+    }
+    map(mapper) {
+        const store = new AsyncStore();
+        this.onChange((value) => {
+            store.set(mapper(value));
+        });
+        return store;
+    }
+    onChange(callback) {
+        const uuid = generateUuid();
+        this._callbacks.set(uuid, callback);
+        return {
+            unsubscribe: () => {
+                this._callbacks.delete(uuid);
+            },
+        };
+    }
+    onceChange(callback) {
+        const { unsubscribe } = this.onChange((...args) => {
+            unsubscribe();
+            callback(...args);
+        });
+        return { unsubscribe };
+    }
+}

package/dist/utils/strings.d.ts

@@ -0,0 +1,40 @@
+export declare function typedToLowercase<S extends string>(s: S): Lowercase<S>;
+export declare function typedToUppercase<S extends string>(s: S): Uppercase<S>;
+/**
+ * Returns all whitespace character at the start of the string.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export declare function getWhitespacePrefix(s: string): string;
+/**
+ * Returns all whitespace character at the end of the string.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export declare function getWhitespaceSuffix(s: string): string;
+/**
+ * Returns a string with all empty or whitespace-only lines at the start removed.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export declare function trimEmptyLinesStart(s: string): string;
+/**
+ * Returns a string with all empty or whitespace-only lines at the end removed.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export declare function trimEmptyLinesEnd(s: string): string;
+/**
+ * Returns a string with all empty or whitespace-only lines trimmed at the start and end.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export declare function trimLines(s: string): string;
+/**
+ * A template literal tag that returns the same string as the template literal without a tag.
+ *
+ * Useful for implementing your own template literal tags.
+ */
+export declare function templateIdentity(strings: TemplateStringsArray | readonly string[], ...values: any[]): string;
+export declare function deindent(code: string): string;
+export declare function deindent(strings: TemplateStringsArray | readonly string[], ...values: any[]): string;

package/dist/utils/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/utils/strings.tsx"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAErE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAErE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAK5G;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;AAC/C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC"}

package/dist/utils/strings.js

@@ -0,0 +1,91 @@
+export function typedToLowercase(s) {
+    return s.toLowerCase();
+}
+export function typedToUppercase(s) {
+    return s.toUpperCase();
+}
+/**
+ * Returns all whitespace character at the start of the string.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export function getWhitespacePrefix(s) {
+    return s.substring(0, s.length - s.trimStart().length);
+}
+/**
+ * Returns all whitespace character at the end of the string.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export function getWhitespaceSuffix(s) {
+    return s.substring(s.trimEnd().length);
+}
+/**
+ * Returns a string with all empty or whitespace-only lines at the start removed.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export function trimEmptyLinesStart(s) {
+    const lines = s.split("\n");
+    const firstNonEmptyLineIndex = lines.findIndex((line) => line.trim() !== "");
+    return lines.slice(firstNonEmptyLineIndex).join("\n");
+}
+/**
+ * Returns a string with all empty or whitespace-only lines at the end removed.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export function trimEmptyLinesEnd(s) {
+    const lines = s.split("\n");
+    const lastNonEmptyLineIndex = lines.findLastIndex((line) => line.trim() !== "");
+    return lines.slice(0, lastNonEmptyLineIndex + 1).join("\n");
+}
+/**
+ * Returns a string with all empty or whitespace-only lines trimmed at the start and end.
+ *
+ * Uses the same definition for whitespace as `String.prototype.trim()`.
+ */
+export function trimLines(s) {
+    return trimEmptyLinesEnd(trimEmptyLinesStart(s));
+}
+/**
+ * A template literal tag that returns the same string as the template literal without a tag.
+ *
+ * Useful for implementing your own template literal tags.
+ */
+export function templateIdentity(strings, ...values) {
+    if (strings.length === 0)
+        return "";
+    if (values.length !== strings.length - 1)
+        throw new Error("Invalid number of values; must be one less than strings");
+    return strings.slice(1).reduce((result, string, i) => `${result}${values[i] ?? "n/a"}${string}`, strings[0]);
+}
+export function deindent(strings, ...values) {
+    if (typeof strings === "string")
+        return deindent([strings]);
+    if (strings.length === 0)
+        return "";
+    if (values.length !== strings.length - 1)
+        throw new Error("Invalid number of values; must be one less than strings");
+    const trimmedStrings = [...strings];
+    trimmedStrings[0] = trimEmptyLinesStart(trimmedStrings[0]);
+    trimmedStrings[trimmedStrings.length - 1] = trimEmptyLinesEnd(trimmedStrings[trimmedStrings.length - 1]);
+    const indentation = trimmedStrings
+        .join("${SOME_VALUE}")
+        .split("\n")
+        .filter((line) => line.trim() !== "")
+        .map((line) => getWhitespacePrefix(line).length)
+        .reduce((min, current) => Math.min(min, current), Infinity);
+    const deindentedStrings = trimmedStrings
+        .map((string, stringIndex) => {
+        return string
+            .split("\n")
+            .map((line, lineIndex) => stringIndex !== 0 && lineIndex === 0 ? line : line.substring(indentation))
+            .join("\n");
+    });
+    const indentedValues = values.map((value, i) => {
+        const firstLineIndentation = getWhitespacePrefix(deindentedStrings[i].split("\n").at(-1));
+        return `${value}`.replaceAll("\n", `\n${firstLineIndentation}`);
+    });
+    return templateIdentity(deindentedStrings, ...indentedValues);
+}

package/dist/utils/types.d.ts

@@ -0,0 +1,33 @@
+import { StatusError } from "./errors";
+export type ReadonlyJson = null | boolean | number | string | readonly ReadonlyJson[] | {
+    readonly [key: string]: ReadonlyJson;
+};
+export declare const AccessTokenExpiredErrorCode = "ACCESS_TOKEN_EXPIRED";
+export declare const GrantInvalidErrorCode = "GRANT_INVALID";
+export declare const UserAlreadyExistErrorCode = "USER_ALREADY_EXIST";
+export declare const UserNotExistErrorCode = "USER_NOT_EXIST";
+export declare const UserNotVerifiedErrorCode = "USER_NOT_VERIFIED";
+export declare const EmailPasswordMissMatchErrorCode = "EMAIL_PASSWORD_MISS_MATCH";
+export declare const RedirectUrlInvalidErrorCode = "REDIRECT_URL_INVALID";
+export declare const PasswordFormatInvalidErrorCode = "PASSWORD_FORMAT_INVALID";
+export declare const ProjectIdOrKeyInvalidErrorCode = "PROJECT_ID_OR_KEY_INVALID";
+export declare const EmailVerificationLinkInvalidErrorCode = "EMAIL_VERIFICATION_LINK_INVALID";
+export declare const EmailVerificationLinkExpiredErrorCode = "EMAIL_VERIFICATION_LINK_EXPIRED";
+export declare const EmailVerificationLinkUsedErrorCode = "EMAIL_VERIFICATION_LINK_USED";
+export declare const PasswordResetLinkInvalidErrorCode = "PASSWORD_RESET_LINK_INVALID";
+export declare const PasswordResetLinkExpiredErrorCode = "PASSWORD_RESET_LINK_EXPIRED";
+export declare const PasswordResetLinkUsedErrorCode = "PASSWORD_RESET_LINK_USED";
+export type KnownErrorCode = typeof GrantInvalidErrorCode | typeof AccessTokenExpiredErrorCode | typeof UserAlreadyExistErrorCode | typeof UserNotExistErrorCode | typeof UserNotVerifiedErrorCode | typeof EmailPasswordMissMatchErrorCode | typeof RedirectUrlInvalidErrorCode | typeof PasswordFormatInvalidErrorCode | typeof ProjectIdOrKeyInvalidErrorCode | typeof EmailVerificationLinkInvalidErrorCode | typeof EmailVerificationLinkExpiredErrorCode | typeof EmailVerificationLinkUsedErrorCode | typeof PasswordResetLinkInvalidErrorCode | typeof PasswordResetLinkExpiredErrorCode | typeof PasswordResetLinkUsedErrorCode;
+export declare const KnownErrorCodes: string[];
+export type SignUpErrorCode = typeof UserAlreadyExistErrorCode;
+export declare const SignUpErrorCodes: string[];
+export type SignInErrorCode = typeof EmailPasswordMissMatchErrorCode | typeof UserNotExistErrorCode;
+export declare const SignInErrorCodes: string[];
+export type EmailVerificationLinkErrorCode = typeof EmailVerificationLinkInvalidErrorCode | typeof EmailVerificationLinkExpiredErrorCode | typeof EmailVerificationLinkUsedErrorCode;
+export declare const EmailVerificationLinkErrorCodes: string[];
+export type PasswordResetLinkErrorCode = typeof PasswordResetLinkInvalidErrorCode | typeof PasswordResetLinkExpiredErrorCode | typeof PasswordResetLinkUsedErrorCode;
+export declare const PasswordResetLinkErrorCodes: string[];
+export declare class KnownError extends StatusError {
+    readonly errorCode: KnownErrorCode;
+    constructor(errorCode: KnownErrorCode);
+}

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKvC,MAAM,MAAM,YAAY,GACpB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,YAAY,EAAE,GACvB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAE7C,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAC9D,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AACtD,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAC5D,eAAO,MAAM,+BAA+B,8BAA8B,CAAC;AAC3E,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AACxE,eAAO,MAAM,8BAA8B,8BAA8B,CAAC;AAC1E,eAAO,MAAM,qCAAqC,oCAAoC,CAAC;AACvF,eAAO,MAAM,qCAAqC,oCAAoC,CAAC;AACvF,eAAO,MAAM,kCAAkC,iCAAiC,CAAC;AACjF,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAC/E,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAC/E,eAAO,MAAM,8BAA8B,6BAA6B,CAAC;AAEzE,MAAM,MAAM,cAAc,GACtB,OAAO,qBAAqB,GAC5B,OAAO,2BAA2B,GAClC,OAAO,yBAAyB,GAChC,OAAO,qBAAqB,GAC5B,OAAO,wBAAwB,GAC/B,OAAO,+BAA+B,GACtC,OAAO,2BAA2B,GAClC,OAAO,8BAA8B,GACrC,OAAO,8BAA8B,GACrC,OAAO,qCAAqC,GAC5C,OAAO,qCAAqC,GAC5C,OAAO,kCAAkC,GACzC,OAAO,iCAAiC,GACxC,OAAO,iCAAiC,GACxC,OAAO,8BAA8B,CAAA;AACzC,eAAO,MAAM,eAAe,UAgB3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,yBAAyB,CAAA;AAC9D,eAAO,MAAM,gBAAgB,UAA8B,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,OAAO,+BAA+B,GAChE,OAAO,qBAAqB,CAAA;AAChC,eAAO,MAAM,gBAAgB,UAG5B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,OAAO,qCAAqC,GACrF,OAAO,qCAAqC,GAAG,OAAO,kCAAkC,CAAA;AAC5F,eAAO,MAAM,+BAA+B,UAI3C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,OAAO,iCAAiC,GAC7E,OAAO,iCAAiC,GAAG,OAAO,8BAA8B,CAAA;AACpF,eAAO,MAAM,2BAA2B,UAIvC,CAAC;AAEF,qBAAa,UAAW,SAAQ,WAAW;aACb,SAAS,EAAE,cAAc;gBAAzB,SAAS,EAAE,cAAc;CAatD"}

package/dist/utils/types.js

@@ -0,0 +1,61 @@
+import { StatusError } from "./errors";
+export const AccessTokenExpiredErrorCode = "ACCESS_TOKEN_EXPIRED";
+export const GrantInvalidErrorCode = "GRANT_INVALID";
+export const UserAlreadyExistErrorCode = "USER_ALREADY_EXIST";
+export const UserNotExistErrorCode = "USER_NOT_EXIST";
+export const UserNotVerifiedErrorCode = "USER_NOT_VERIFIED";
+export const EmailPasswordMissMatchErrorCode = "EMAIL_PASSWORD_MISS_MATCH";
+export const RedirectUrlInvalidErrorCode = "REDIRECT_URL_INVALID";
+export const PasswordFormatInvalidErrorCode = "PASSWORD_FORMAT_INVALID";
+export const ProjectIdOrKeyInvalidErrorCode = "PROJECT_ID_OR_KEY_INVALID";
+export const EmailVerificationLinkInvalidErrorCode = "EMAIL_VERIFICATION_LINK_INVALID";
+export const EmailVerificationLinkExpiredErrorCode = "EMAIL_VERIFICATION_LINK_EXPIRED";
+export const EmailVerificationLinkUsedErrorCode = "EMAIL_VERIFICATION_LINK_USED";
+export const PasswordResetLinkInvalidErrorCode = "PASSWORD_RESET_LINK_INVALID";
+export const PasswordResetLinkExpiredErrorCode = "PASSWORD_RESET_LINK_EXPIRED";
+export const PasswordResetLinkUsedErrorCode = "PASSWORD_RESET_LINK_USED";
+export const KnownErrorCodes = [
+    AccessTokenExpiredErrorCode,
+    GrantInvalidErrorCode,
+    UserAlreadyExistErrorCode,
+    UserNotExistErrorCode,
+    UserNotVerifiedErrorCode,
+    EmailPasswordMissMatchErrorCode,
+    RedirectUrlInvalidErrorCode,
+    PasswordFormatInvalidErrorCode,
+    ProjectIdOrKeyInvalidErrorCode,
+    EmailVerificationLinkInvalidErrorCode,
+    EmailVerificationLinkExpiredErrorCode,
+    EmailVerificationLinkUsedErrorCode,
+    PasswordResetLinkInvalidErrorCode,
+    PasswordResetLinkExpiredErrorCode,
+    PasswordResetLinkUsedErrorCode,
+];
+export const SignUpErrorCodes = [UserAlreadyExistErrorCode];
+export const SignInErrorCodes = [
+    EmailPasswordMissMatchErrorCode,
+    UserNotExistErrorCode
+];
+export const EmailVerificationLinkErrorCodes = [
+    EmailVerificationLinkInvalidErrorCode,
+    EmailVerificationLinkExpiredErrorCode,
+    EmailVerificationLinkUsedErrorCode
+];
+export const PasswordResetLinkErrorCodes = [
+    PasswordResetLinkInvalidErrorCode,
+    PasswordResetLinkExpiredErrorCode,
+    PasswordResetLinkUsedErrorCode
+];
+export class KnownError extends StatusError {
+    errorCode;
+    constructor(errorCode) {
+        super(401, JSON.stringify({
+            error_code: errorCode,
+        }), {
+            headers: {
+                "content-type": "application/json",
+            },
+        });
+        this.errorCode = errorCode;
+    }
+}

package/dist/utils/uuids.d.ts

@@ -0,0 +1 @@
+export declare function generateUuid(): string;

package/dist/utils/uuids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuids.d.ts","sourceRoot":"","sources":["../../src/utils/uuids.tsx"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,WAE3B"}

package/dist/utils/uuids.js

@@ -0,0 +1,4 @@
+import { v4 as uuidv4 } from 'uuid';
+export function generateUuid() {
+    return uuidv4();
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@stackframe/stack-shared",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "bcrypt": "^5.1.1",
+    "jose": "^5.2.2",
+    "oauth4webapi": "^2.10.3",
+    "uuid": "^9.0.1"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^5.0.2",
+    "@types/react": "^18.2.60",
+    "@types/uuid": "^9.0.8",
+    "@typescript-eslint/eslint-plugin": "^6",
+    "@typescript-eslint/parser": "^6.x",
+    "eslint": "^8",
+    "eslint-config-next": "^14",
+    "rimraf": "^5.0.5"
+  },
+  "scripts": {
+    "build": "pnpm clean && tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "dev": "tsc -w --preserveWatchOutput --declarationMap",
+    "lint": "eslint --ext .tsx,.ts ."
+  }
+}