@idb-orm/core 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,125 +1,38 @@
1
1
  import { CompiledDb } from "../builder.js";
2
- import {
3
- BaseRelation,
4
- Field,
5
- OptionalRelation,
6
- PrimaryKey,
7
- Relation,
8
- RelationArray,
9
- RelationOutput,
10
- ValidValue,
11
- } from "../field/index.js";
2
+ import { BaseRelation, Field, OptionalRelation, PrimaryKey, Relation, RelationArray, RelationOutput, ValidValue } from "../field";
12
3
  import { Dict, Keyof, ZodWrap } from "../types/common.js";
13
4
  import Model from "./model.js";
14
- export type FindPrimaryKey<F extends Record<string, ValidValue>> = Extract<
15
- {
16
- [K in keyof F]: F[K] extends PrimaryKey<any, any> ? K : never;
17
- }[keyof F],
18
- string
19
- >;
20
- export type PrimaryKeyType<M extends Model<any, any, any>> = M extends Model<
21
- any,
22
- infer F,
23
- any
24
- >
25
- ? {
26
- [K in keyof F]: F[K] extends PrimaryKey<any, infer Type>
27
- ? Type
28
- : never;
29
- }[keyof F]
30
- : never;
5
+ export type FindPrimaryKey<F extends Record<string, ValidValue>> = Extract<{
6
+ [K in keyof F]: F[K] extends PrimaryKey<any, any> ? K : never;
7
+ }[keyof F], string>;
8
+ export type PrimaryKeyType<M extends Model<any, any, any>> = M extends Model<any, infer F, any> ? {
9
+ [K in keyof F]: F[K] extends PrimaryKey<any, infer Type> ? Type : never;
10
+ }[keyof F] : never;
31
11
  export interface ModelCache {
32
12
  delete?: Set<string>;
33
13
  }
34
14
  /**
35
15
  * Gets the type of a relation given its name
36
16
  */
37
- export type RelationValue<Name extends string, C> = Name extends keyof C
38
- ? C[Name] extends Model<any, infer Fields, infer PrimaryKey>
39
- ? RelationOutput<Fields[PrimaryKey]>
40
- : never
41
- : never;
17
+ export type RelationValue<Name extends string, C> = Name extends keyof C ? C[Name] extends Model<any, infer Fields, infer PrimaryKey> ? RelationOutput<Fields[PrimaryKey]> : never : never;
42
18
  /**
43
19
  * Gets the primitive type of the relation field
44
20
  */
45
- export type GetRelationField<F, C> = F extends Relation<infer To, any>
46
- ? RelationValue<To, C>
47
- : F extends OptionalRelation<infer To, any>
48
- ? RelationValue<To, C> | undefined
49
- : F extends RelationArray<infer To, any>
50
- ? RelationValue<To, C>[]
51
- : never;
21
+ export type GetRelationField<F, C> = F extends Relation<infer To, any> ? RelationValue<To, C> : F extends OptionalRelation<infer To, any> ? RelationValue<To, C> | undefined : F extends RelationArray<infer To, any> ? RelationValue<To, C>[] : never;
52
22
  export type ModelStructure<F extends Dict<ValidValue>, C> = {
53
- [K in keyof F]: F[K] extends Field<infer Output, any>
54
- ? Output
55
- : F[K] extends PrimaryKey<any, infer Type>
56
- ? Type
57
- : GetRelationField<F[K], C>;
23
+ [K in keyof F]: F[K] extends Field<infer Output, any> ? Output : F[K] extends PrimaryKey<any, infer Type> ? Type : GetRelationField<F[K], C>;
58
24
  };
59
- export type ModelType<
60
- M extends Model<any, any, any>,
61
- C extends CompiledDb<any, any, any>
62
- > = M extends Model<any, infer Fields, any>
63
- ? C extends CompiledDb<any, any, infer Collection>
64
- ? ModelStructure<Fields, Collection>
65
- : never
66
- : never;
67
- export type ExtractFields<M extends Model<any, any, any>> = M extends Model<
68
- any,
69
- infer Fields,
70
- any
71
- >
72
- ? Fields
73
- : never;
74
- export type AllRelationKeys<M extends Model<any, any, any>> = M extends Model<
75
- any,
76
- infer Fields,
77
- any
78
- >
79
- ? {
80
- [K in Keyof<Fields>]: Fields[K] extends BaseRelation<any, any>
81
- ? K
82
- : never;
83
- }[Keyof<Fields>]
84
- : never;
85
- export type RelationlessModelStructure<M extends Model<any, any, any>> =
86
- M extends Model<any, infer Fields, any>
87
- ? Omit<
88
- {
89
- [K in Keyof<Fields>]: Fields[K] extends BaseRelation<any, any>
90
- ? unknown
91
- : Fields[K] extends Field<infer Type, any>
92
- ? Type
93
- : Fields[K] extends PrimaryKey<any, infer Type>
94
- ? Type
95
- : never;
96
- },
97
- AllRelationKeys<M>
98
- >
99
- : never;
100
- export type CollectionZodSchema<C> = C extends Record<
101
- infer Keys,
102
- Model<any, any, any>
103
- >
104
- ? {
105
- [K in Keys]: C[K] extends Model<any, infer Fields, any>
106
- ? ZodWrap<ModelStructure<Fields, C>>
107
- : never;
108
- }
109
- : never;
110
- export type FindRelationKey<
111
- From extends string,
112
- RelationName extends string,
113
- M extends Model<any, any, any>
114
- > = M extends Model<any, infer Fields, any>
115
- ? {
116
- [K in Keyof<Fields>]: Fields[K] extends BaseRelation<
117
- From,
118
- infer CurName
119
- >
120
- ? CurName extends RelationName
121
- ? K
122
- : never
123
- : never;
124
- }[Keyof<Fields>]
125
- : never;
25
+ export type ModelType<M extends Model<any, any, any>, C extends CompiledDb<any, any, any>> = M extends Model<any, infer Fields, any> ? C extends CompiledDb<any, any, infer Collection> ? ModelStructure<Fields, Collection> : never : never;
26
+ export type ExtractFields<M extends Model<any, any, any>> = M extends Model<any, infer Fields, any> ? Fields : never;
27
+ export type AllRelationKeys<M extends Model<any, any, any>> = M extends Model<any, infer Fields, any> ? {
28
+ [K in Keyof<Fields>]: Fields[K] extends BaseRelation<any, any> ? K : never;
29
+ }[Keyof<Fields>] : never;
30
+ export type RelationlessModelStructure<M extends Model<any, any, any>> = M extends Model<any, infer Fields, any> ? Omit<{
31
+ [K in Keyof<Fields>]: Fields[K] extends BaseRelation<any, any> ? unknown : Fields[K] extends Field<infer Type, any> ? Type : Fields[K] extends PrimaryKey<any, infer Type> ? Type : never;
32
+ }, AllRelationKeys<M>> : never;
33
+ export type CollectionZodSchema<C> = C extends Record<infer Keys, Model<any, any, any>> ? {
34
+ [K in Keys]: C[K] extends Model<any, infer Fields, any> ? ZodWrap<ModelStructure<Fields, C>> : never;
35
+ } : never;
36
+ export type FindRelationKey<From extends string, RelationName extends string, M extends Model<any, any, any>> = M extends Model<any, infer Fields, any> ? {
37
+ [K in Keyof<Fields>]: Fields[K] extends BaseRelation<From, infer CurName> ? CurName extends RelationName ? K : never : never;
38
+ }[Keyof<Fields>] : never;
@@ -1,20 +1,10 @@
1
1
  import z from "zod";
2
2
  import { CollectionObject } from "../builder.js";
3
3
  import { DbClient } from "../client/index.js";
4
- import {
5
- BaseRelation,
6
- Field,
7
- FieldTypes,
8
- PrimaryKey,
9
- ValidValue,
10
- } from "../field/index.js";
4
+ import { BaseRelation, Field, FieldTypes, PrimaryKey, ValidValue } from "../field";
11
5
  import { Keyof, ValidKey } from "../types/common.js";
12
6
  import { FindPrimaryKey } from "./model-types.js";
13
- export default class Model<
14
- Name extends string,
15
- F extends Record<string, ValidValue>,
16
- Primary extends FindPrimaryKey<F> = FindPrimaryKey<F>
17
- > {
7
+ export default class Model<Name extends string, F extends Record<string, ValidValue>, Primary extends FindPrimaryKey<F> = FindPrimaryKey<F>> {
18
8
  readonly name: Name;
19
9
  private readonly fields;
20
10
  private readonly fieldKeys;
@@ -25,18 +15,10 @@ export default class Model<
25
15
  get<K extends Keyof<F>>(key: K): F[K];
26
16
  getModelField(key: string): Field<any, any> | undefined;
27
17
  getPrimaryKey(): PrimaryKey<boolean, ValidKey>;
28
- getRelation<Models extends string>(
29
- key: string
30
- ): BaseRelation<Models, string> | undefined;
18
+ getRelation<Models extends string>(key: string): BaseRelation<Models, string> | undefined;
31
19
  keyType(key: Keyof<F>): FieldTypes;
32
20
  links<Names extends string = string>(): SetIterator<Names>;
33
21
  keys(): Keyof<F>[];
34
- parseField<K extends Keyof<F>>(
35
- field: K,
36
- value: unknown
37
- ): z.ZodSafeParseResult<any>;
38
- getDeletedStores<
39
- ModelNames extends string,
40
- Models extends CollectionObject<ModelNames>
41
- >(client: DbClient<string, ModelNames, Models>): Set<ModelNames>;
22
+ parseField<K extends Keyof<F>>(field: K, value: unknown): z.ZodSafeParseResult<any>;
23
+ getDeletedStores<ModelNames extends string, Models extends CollectionObject<ModelNames>>(client: DbClient<string, ModelNames, Models>): Set<ModelNames>;
42
24
  }
@@ -1,10 +1,9 @@
1
1
  /**
2
2
  * A paper thin wrapper around IDBObjectStore
3
3
  */
4
- import { Promisable } from "type-fest";
5
4
  import { StoreError } from "./error.js";
6
5
  import { Transaction } from "./transaction.js";
7
- import { Dict, ValidKey } from "./types/common.js";
6
+ import { Dict, Promisable, ValidKey } from "./types/common.js";
8
7
  export declare class ObjectStore {
9
8
  private readonly tx;
10
9
  readonly store: IDBObjectStore;
@@ -1,21 +1,15 @@
1
- import type { Arrayable } from "type-fest";
2
- import { StoreError } from "./error.js";
1
+ import { StoreError } from "./error";
3
2
  import { ObjectStore } from "./object-store.js";
3
+ import { Arrayable } from "./types/common.js";
4
4
  export type TransactionStatus = "running" | "aborted" | "complete" | "error";
5
- export type TransactionEventHandler = (
6
- tx: Transaction<IDBTransactionMode>,
7
- ev: Event
8
- ) => void;
9
- export interface TransactionOptions
10
- extends Partial<{
11
- onAbort: TransactionEventHandler;
12
- onError: TransactionEventHandler;
13
- onComplete: TransactionEventHandler;
14
- }> {}
15
- export declare class Transaction<
16
- Mode extends IDBTransactionMode,
17
- Stores extends string = string
18
- > {
5
+ export type TransactionEventHandler = (tx: Transaction<IDBTransactionMode>, ev: Event) => void;
6
+ export interface TransactionOptions extends Partial<{
7
+ onAbort: TransactionEventHandler;
8
+ onError: TransactionEventHandler;
9
+ onComplete: TransactionEventHandler;
10
+ }> {
11
+ }
12
+ export declare class Transaction<Mode extends IDBTransactionMode, Stores extends string = string> {
19
13
  private internal;
20
14
  status: TransactionStatus;
21
15
  error: StoreError | null;
@@ -24,12 +18,7 @@ export declare class Transaction<
24
18
  * A record of store names to `IDBObjectStore` objects
25
19
  */
26
20
  private readonly objectStores;
27
- constructor(
28
- db: IDBDatabase,
29
- stores: Arrayable<Stores>,
30
- mode: Mode,
31
- options?: TransactionOptions
32
- );
21
+ constructor(db: IDBDatabase, stores: Arrayable<Stores>, mode: Mode, options?: TransactionOptions);
33
22
  abort(error: StoreError): StoreError;
34
23
  commit(): void;
35
24
  /**
@@ -1,9 +1,11 @@
1
- import type { Arrayable, IsNever } from "type-fest";
2
1
  import type z from "zod";
3
2
  /**
4
3
  * Extracts the string keys of an object
5
4
  */
6
5
  export type Keyof<T extends Record<any, any>> = Extract<keyof T, string>;
6
+ export type Arrayable<T> = T | T[];
7
+ export type IsNever<T> = [T] extends [never] ? true : false;
8
+ export type Promisable<T> = T | Promise<T>;
7
9
  export type MakeOptional<B extends boolean, T> = B extends true ? T | undefined : T;
8
10
  export type MakeArray<B extends boolean, T> = B extends true ? T[] : T;
9
11
  export type MakeArrayable<B extends boolean, T> = B extends true ? Arrayable<T> : T;
@@ -34,4 +36,5 @@ export type PartialOnUndefined<T extends Dict> = Required<T> & Optional<T>;
34
36
  * Types that can be resolved to specific boolean values
35
37
  */
36
38
  export type BooleanLike = boolean | undefined | null | 0;
39
+ export type Literable = string | number | bigint | boolean | null | undefined;
37
40
  export {};
package/dist/utils.d.ts CHANGED
@@ -1,5 +1,4 @@
1
- import type { Keyof } from "./types/common";
2
- import type { Arrayable } from "type-fest";
1
+ import type { Arrayable, Keyof } from "./types/common";
3
2
  import type { Transaction } from "./transaction.js";
4
3
  export declare function handleRequest<T>(req: IDBRequest<T>, tx?: Transaction<any, any>): Promise<T>;
5
4
  export declare function getKeys<T extends object>(obj: T): Keyof<T>[];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@idb-orm/core",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",
package/eslint.config.js DELETED
@@ -1,55 +0,0 @@
1
- import eslint from "@eslint/js";
2
- import { defineConfig } from "eslint/config";
3
- import tseslint from "typescript-eslint";
4
- import globals from "globals";
5
- import path from "path";
6
-
7
- export default defineConfig(
8
- eslint.configs.recommended,
9
- tseslint.configs.recommendedTypeChecked,
10
- {
11
- rules: {
12
- "@typescript-eslint/no-explicit-any": "off",
13
- "@typescript-eslint/no-unsafe-function-type": "off",
14
- "@typescript-eslint/no-unsafe-assignment": "off",
15
- "@typescript-eslint/no-unsafe-member-access": "off",
16
- "@typescript-eslint/restrict-template-expressions": "off",
17
- "@typescript-eslint/no-empty-object-type": "off",
18
- "@typescript-eslint/switch-exhaustiveness-check": [
19
- "error",
20
- {
21
- considerDefaultExhaustiveForUnions: true,
22
- },
23
- ],
24
- "@typescript-eslint/no-unused-vars": [
25
- "error",
26
- {
27
- args: "all",
28
- argsIgnorePattern: "^_",
29
- caughtErrors: "all",
30
- caughtErrorsIgnorePattern: "^_",
31
- destructuredArrayIgnorePattern: "^_",
32
- varsIgnorePattern: "^_",
33
- ignoreRestSiblings: true,
34
- },
35
- ],
36
- },
37
- languageOptions: {
38
- parserOptions: {
39
- projectService: true,
40
- tsconfigRootDir: path.resolve("./packages/core"),
41
- },
42
- globals: globals.browser,
43
- },
44
- },
45
- {
46
- ignores: [
47
- "eslint.config.js",
48
- "rollup.config.ts",
49
- "**/dist/*",
50
- "**/test-client/*",
51
- "**/*.config.*",
52
- "**/tests/*",
53
- ],
54
- }
55
- );
@@ -1,79 +0,0 @@
1
- import { defineConfig, devices } from "@playwright/test";
2
-
3
- /**
4
- * Read environment variables from file.
5
- * https://github.com/motdotla/dotenv
6
- */
7
- // import dotenv from 'dotenv';
8
- // import path from 'path';
9
- // dotenv.config({ path: path.resolve(__dirname, '.env') });
10
-
11
- /**
12
- * See https://playwright.dev/docs/test-configuration.
13
- */
14
- export default defineConfig({
15
- testDir: "./tests",
16
- /* Run tests in files in parallel */
17
- fullyParallel: true,
18
- /* Fail the build on CI if you accidentally left test.only in the source code. */
19
- forbidOnly: !!process.env.CI,
20
- /* Retry on CI only */
21
- retries: process.env.CI ? 2 : 0,
22
- /* Opt out of parallel tests on CI. */
23
- workers: process.env.CI ? 1 : undefined,
24
- /* Reporter to use. See https://playwright.dev/docs/test-reporters */
25
- // reporter: "html",
26
- /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
27
- use: {
28
- /* Base URL to use in actions like `await page.goto('')`. */
29
- // baseURL: 'http://localhost:3000',
30
-
31
- /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
32
- trace: "on-first-retry",
33
- headless: true,
34
- },
35
-
36
- /* Configure projects for major browsers */
37
- projects: [
38
- {
39
- name: "chromium",
40
- use: { ...devices["Desktop Chrome"] },
41
- },
42
-
43
- {
44
- name: "firefox",
45
- use: { ...devices["Desktop Firefox"] },
46
- },
47
-
48
- {
49
- name: "webkit",
50
- use: { ...devices["Desktop Safari"] },
51
- },
52
-
53
- /* Test against mobile viewports. */
54
- // {
55
- // name: 'Mobile Chrome',
56
- // use: { ...devices['Pixel 5'] },
57
- // },
58
- // {
59
- // name: 'Mobile Safari',
60
- // use: { ...devices['iPhone 12'] },
61
- // },
62
-
63
- /* Test against branded browsers. */
64
- // {
65
- // name: 'Microsoft Edge',
66
- // use: { ...devices['Desktop Edge'], channel: 'msedge' },
67
- // },
68
- // {
69
- // name: 'Google Chrome',
70
- // use: { ...devices['Desktop Chrome'], channel: 'chrome' },
71
- // },
72
- ],
73
-
74
- /* Run your local dev server before starting the tests */
75
- webServer: {
76
- command: "npx serve dist -l 4173",
77
- port: 4173,
78
- },
79
- });
package/tests/helpers.ts DELETED
@@ -1,72 +0,0 @@
1
- import { Page } from "@playwright/test";
2
- import { Keyof } from "../src/types/common.js";
3
-
4
- /**
5
- * Will navigate to the served page and import zod and the package
6
- *
7
- * Will also ensure that the package is properly loaded
8
- * @param context Playwright BrowserContext
9
- */
10
- export async function populatePage<P extends Record<string, any>>(
11
- page: Page,
12
- vars: Record<keyof P, string | EvalFn<P, any>>
13
- ) {
14
- await page.goto("http://localhost:4173/");
15
- const manager = new ContextSession<P>(page, vars);
16
- await manager.populate();
17
- return manager;
18
- }
19
-
20
- function getFn(fn: Function) {
21
- return fn.toString().match(/^async \(\{([^\}]+)\}\) \=\> \{([\s\S]*)\}$/m);
22
- }
23
-
24
- export type EvalFn<
25
- Types extends Record<string, any>,
26
- This extends keyof Types
27
- > = (args: Omit<Types, This>) => Promise<any>;
28
-
29
- export class ContextSession<Types extends Record<string, any>> {
30
- constructor(
31
- private page: Page,
32
- private variables: {
33
- [K in keyof Types]: string | EvalFn<Types, K>;
34
- }
35
- ) {}
36
-
37
- async populate() {
38
- // Construct the script
39
- await this.page.addScriptTag({
40
- type: "module",
41
- content: `
42
- window.isReady = (async () => {
43
- window.vars = {};
44
- ${Object.keys(this.variables)
45
- .map((key) => {
46
- const element = this.variables[key];
47
- switch (typeof element) {
48
- case "function":
49
- return `window.vars.${key} = await (${element.toString()})(window.vars);`;
50
- default:
51
- return `window.vars.${key} = await ${element};`;
52
- }
53
- })
54
- .join("\n")}
55
- })();
56
- `,
57
- });
58
-
59
- await this.page.evaluate(async () => {
60
- await (window as any).isReady;
61
- await new Promise((res) => setTimeout(res, 100));
62
- });
63
- }
64
-
65
- async evaluate<Result>(
66
- fn: (args: Types) => Promise<Result>
67
- ): Promise<Result> {
68
- return await this.page.evaluate(
69
- `(async () => await (${fn.toString()})(window.vars))();`
70
- );
71
- }
72
- }
@@ -1,101 +0,0 @@
1
- import { test, expect, Page } from "@playwright/test";
2
- import { ContextSession, EvalFn, populatePage } from "./helpers.js";
3
- import { Builder, Field } from "../dist/index.js";
4
- import * as idbOrm from "../dist/index.js";
5
- import * as zod from "zod";
6
-
7
- export type Packages = {
8
- pkg: typeof idbOrm;
9
- zod: typeof zod;
10
- };
11
- export type SessionArguments = Packages & {
12
- client: Awaited<ReturnType<typeof createDb>>;
13
- };
14
-
15
- const createDb = async ({ zod, pkg }: Packages) => {
16
- const Builder = pkg.Builder;
17
- const Field = pkg.Field;
18
- const z = zod;
19
- const builder = new Builder("testdb", ["classes", "spellLists", "spells"]);
20
-
21
- const classStore = builder.defineModel("classes", {
22
- id: Field.primaryKey().autoIncrement(),
23
- name: Field.string(),
24
- description: Field.string().array(),
25
- spellList: Field.relation("spellLists", {
26
- name: "spellList2class",
27
- }).optional({ onDelete: "SetNull" }),
28
- });
29
-
30
- const spellListStore = builder.defineModel("spellLists", {
31
- id: Field.primaryKey().autoIncrement(),
32
- name: Field.string(),
33
- class: Field.relation("classes", {
34
- name: "spellList2class",
35
- onDelete: "Cascade",
36
- }).optional(),
37
- spells: Field.relation("spells", {
38
- name: "spells2spellLists",
39
- }).array(),
40
- });
41
-
42
- const spellStore = builder.defineModel("spells", {
43
- id: Field.primaryKey().autoIncrement(),
44
- name: Field.string(),
45
- range: Field.string(),
46
- components: Field.custom(z.enum(["V", "S", "M"]).array()),
47
- level: Field.number().default(0),
48
- lists: Field.relation("spellLists", {
49
- name: "spells2spellLists",
50
- }).array(),
51
- });
52
-
53
- const db = builder.compile({
54
- classes: classStore,
55
- spellLists: spellListStore,
56
- spells: spellStore,
57
- });
58
-
59
- const client = await db.createClient();
60
- return client;
61
- };
62
-
63
- test.describe.configure({ mode: "default" });
64
- test.describe("1 page multi-test", () => {
65
- let page: Page;
66
- let session: ContextSession<SessionArguments>;
67
- test.beforeAll(async ({ browser }) => {
68
- const context = await browser.newContext();
69
- page = await context.newPage();
70
- session = await populatePage<SessionArguments>(page, {
71
- pkg: "import('./index.js')",
72
- zod: 'import("https://cdn.jsdelivr.net/npm/zod@4.1.12/+esm")',
73
- client: createDb as any,
74
- });
75
- });
76
-
77
- test.afterAll(async ({ browser }) => {
78
- await browser.close();
79
- });
80
-
81
- test("Sample DB", async () => {
82
- const result = await session.evaluate(async ({ client }) => {
83
- const stores = client.stores;
84
- await stores.spells.add({
85
- name: "Acid Splash",
86
- level: 0,
87
- components: ["V"],
88
- range: "15 feet",
89
- });
90
- await stores.spells.add({
91
- name: "Chromatic Orb",
92
- level: 1,
93
- components: ["V", "S"],
94
- range: "120 feet",
95
- });
96
- return await stores.spells.find({ where: { level: 0 } });
97
- });
98
- expect(result).toBeInstanceOf(Array);
99
- expect(result.length === 1).toBeTruthy();
100
- });
101
- });