@tanglemedia/svelte-starter-directus-api 6.0.2 → 8.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanglemedia/svelte-starter-directus-api",
-  "version": "6.0.2",
+  "version": "8.1.0",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "description": "directus API wrapper for all the directus sdk functionality",
@@ -22,31 +22,28 @@
     }
   },
   "devDependencies": {
-    "@directus/types": "13.0.0",
-    "@sveltejs/adapter-auto": "^4.0.0",
-    "@sveltejs/package": "^2.3.10",
-    "@sveltejs/vite-plugin-svelte": "^5.0.3",
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/svelte": "^5.2.7",
-    "@vitest/coverage-v8": "^3.0.8",
-    "jsdom": "^26.0.0",
-    "msw": "^2.7.3",
-    "svelte": "^5.22.6",
-    "svelte-check": "^4.1.5",
-    "vite": "^6.2.1",
-    "vitest": "^3.0.8",
-    "@internal/eslint-config": "0.0.0",
-    "@tanglemedia/svelte-starter-core": "2.0.0"
+    "@directus/types": "15.0.3",
+    "@sveltejs/adapter-auto": "^7.0.1",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "@tanglemedia/svelte-starter-core": "3.1.0",
+    "@testing-library/jest-dom": "^6.10.0",
+    "@testing-library/svelte": "^5.4.2",
+    "@vitest/coverage-v8": "^4.1.10",
+    "jsdom": "^26.1.0",
+    "msw": "^2.15.0",
+    "svelte": "^5.57.3",
+    "svelte-check": "^4.7.7",
+    "vite": "^8.3.5",
+    "vitest": "^4.1.10"
   },
   "dependencies": {
-    "@directus/sdk": "19.0.1",
-    "@types/js-cookie": "^3.0.6",
-    "esm-env": "^1.2.2",
-    "js-cookie": "^3.0.5"
+    "@directus/sdk": "21.3.0",
+    "esm-env": "^1.2.2"
   },
   "peerDependencies": {
     "@sveltejs/kit": ">=2 <3",
-    "@tanglemedia/svelte-starter-core": ">=2.0.0",
+    "@tanglemedia/svelte-starter-core": ">=3.0.0",
     "svelte": "^4.0.0 || >=5.0.0"
   },
   "scripts": {

package/src/adapter/api-adapter.ts

@@ -10,9 +10,7 @@ import {
   updateItems,
   uploadFiles,
   type AllCollections,
-  type DirectusClient,
-  type RegularCollections,
-  type RestClient
+  type RegularCollections
 } from '@directus/sdk';
 import {
   ApiAdapterAbstract,
@@ -24,25 +22,49 @@ import {
   type ApiDeleteManyQuery,
   type ApiFindQuery,
   type ApiId,
+  type ApiPatchQuery,
+  type ApiPostQuery,
+  type ApiPutQuery,
   type ApiResponse,
   type ApiUpdateManyQuery,
   type BaseApiMethods,
   type HandleEvent
 } from '@tanglemedia/svelte-starter-core';
-import type { DirectusConfig, SchemaShape } from '../types/adapter.types';
+import type {
+  DirectusAdapterClient,
+  DirectusApiAdapterOptions,
+  DirectusConfig,
+  SchemaShape
+} from '../types/adapter.types';
+
+type PathKey<Schema extends SchemaShape> = Extract<RegularCollections<Schema>, string>;
+
+export type AdapterClient<Schema extends SchemaShape = SchemaShape> = DirectusAdapterClient<Schema>;
+
+const allowedQueryKeys = [
+  'fields',
+  'sort',
+  'filter',
+  'limit',
+  'offset',
+  'page',
+  'search',
+  'version',
+  'versionRaw',
+  'export',
+  'group',
+  'aggregate',
+  'deep',
+  'alias'
+] as const;
+
+type Q = Record<string, unknown>;
 
-export type AdapterClient<Schema extends SchemaShape = SchemaShape> = DirectusClient<Schema> &
-  RestClient<Schema>;
-
-/**
- * TODO: Various types fixes. The current adapter doesn't correctly follow the types defined under the ApiAdapterAbstract.
- * See the fetch adapter under the core
- */
 export class DirectusApiAdapter<
     Schema extends SchemaShape = SchemaShape,
-    Path extends RegularCollections<Schema> = RegularCollections<Schema>
+    Path extends PathKey<Schema> = PathKey<Schema>
   >
-  extends ApiAdapterAbstract<DirectusConfig, ApiAdapterRequestConfig, Path, AdapterClient>
+  extends ApiAdapterAbstract<DirectusConfig, ApiAdapterRequestConfig, Path, AdapterClient<Schema>>
   implements ApiAdapterHandle
 {
   constructor(
@@ -53,8 +75,7 @@ export class DirectusApiAdapter<
   }
 
   async handle(event: HandleEvent) {
-    const f = event.fetch;
-    this.directus.globals.fetch = f;
+    this.directus.globals.fetch = event.fetch;
   }
 
   getAdapterClient(): AdapterClient<Schema> | null {
@@ -65,51 +86,60 @@ export class DirectusApiAdapter<
     const payload = response.data,
       meta = response.meta as Record<string, unknown>;
 
-    if (!meta) {
-      return {};
-    }
-
-    if (typeof meta.total === 'undefined') {
+    if (!meta || typeof meta.total === 'undefined') {
       return {};
     }
 
     const displayed = Array.isArray(payload) ? payload.length : 0;
-
     const total = Number(meta.total);
 
-    // todo: Transform or attempt to get meta information
-    // consider pulling count based on existing filters in order to determine pagination
     return { total, displayed };
   }
 
-  async includeTotals(collection: AllCollections<Schema>, query?: ApiFindQuery<any>) {
+  /**
+   * Counts the items matching the query's `filter` and `search`, or returns `null` when
+   * `includeTotals` is not enabled on the adapter. Side effect: sends an aggregate request
+   * to Directus.
+   *
+   * A per-request `config.configuration` can override `totalAggregate` and `totalField`,
+   * for example to count a collection whose primary key is not `id`.
+   *
+   * @example
+   * await adapter.includeTotals('clinics', { filter }, { configuration: { totalField: 'ID' } });
+   * // requests aggregate={"countDistinct":"ID"} when the adapter uses countDistinct
+   */
+  async includeTotals(
+    collection: Path,
+    query?: ApiFindQuery<any>,
+    config?: ApiAdapterRequestConfig
+  ): Promise<number | null> {
     if (true !== this.config.configuration.includeTotals) {
       return null;
     }
 
     const { filter, search } = query || {};
-
+    const override = config?.configuration as Partial<DirectusApiAdapterOptions> | undefined;
     // default to count. Note that there is a bug in directus where
     // the wrong counts are being returned if there are nested filters.
     // A quick fix is to set totalAggregate to countDistinct
-    const k = this.config.configuration.totalAggregate || 'count';
-    const f = this.config.configuration.totalField || 'id';
+    const k = override?.totalAggregate ?? (this.config.configuration.totalAggregate || 'count');
+    const f = override?.totalField ?? (this.config.configuration.totalField || 'id');
 
-    const data = await this.directus.request(
-      aggregate(collection, {
+    const data = await this.directus.request<Array<Record<string, unknown>>>(
+      aggregate(collection as unknown as AllCollections<Schema>, {
         aggregate: { [k]: f },
         query: {
           ...(filter ? { filter } : {}),
           ...(search ? { search } : {})
         }
-      })
+      } as never)
     );
 
     let total = 0;
 
     if (data && data.length === 1) {
       const c = data[0][k];
-      total = c && typeof c === 'object' ? Number(c[f]) : Number(c);
+      total = c && typeof c === 'object' ? Number((c as Record<string, unknown>)[f]) : Number(c);
     }
 
     return isNaN(total) ? 0 : total;
@@ -118,157 +148,269 @@ export class DirectusApiAdapter<
   async transformResponse<T, M extends object = AnyObject>(
     res: { data: T; meta?: AnyObject },
     status: number = 200
-  ): Promise<ApiResponse<T, Response, M>> {
+  ): Promise<ApiResponse<T, null, M>> {
     return {
-      body: await this.envelopeResponse<T, M>(
+      body: (await this.envelopeResponse<T, M>(
         res.data,
         (res.meta ? this.normalizeMeta(res as AnyObject) : {}) as M
-      ),
-      status: status,
+      )) as ApiResponse<T, null, M>['body'],
+      status,
       statusText: 'OK',
       headers: {},
       adapterResponse: null
     };
   }
 
-  public getConfig(configuration?: unknown): DirectusConfig {
-    const client = this.directus;
+  normalizeQuery(config: ApiAdapterRequestConfig = {}, merge?: Q) {
+    const q = { ...((config?.params as Q | undefined) || {}) };
+    const c = { ...config } as Q;
+    const r = allowedQueryKeys.reduce<Q>(
+      (acc, k) => (typeof c[k] !== 'undefined' ? ((acc[k] = c[k]), acc) : acc),
+      {}
+    );
 
-    // Add the 'configuration' property to the returned object
-    const config: DirectusConfig = {
-      ...this.config,
-      configuration: configuration ?? this.config.configuration ?? {} // Use the provided configuration or an empty object if not provided
+    return {
+      ...q,
+      ...r,
+      ...(merge || {})
     };
+  }
+
+  getId(data: object, config?: ApiAdapterRequestConfig): ApiId | null {
+    const d = data as Record<string, unknown>;
+    const q = config?.params as Q | undefined;
+
+    if (typeof d.id === 'string' || typeof d.id === 'number') {
+      return d.id;
+    }
 
-    return Object.assign(client, config);
+    if (q && (typeof q.id === 'string' || typeof q.id === 'number')) {
+      return q.id;
+    }
+
+    return null;
   }
 
-  public async request<T>(
+  stripId(config?: ApiAdapterRequestConfig) {
+    const q = config?.params as Q | undefined;
+
+    if (!q || typeof q.id === 'undefined') {
+      return config;
+    }
+
+    const { id: _id, ...params } = q;
+
+    return {
+      ...config,
+      params
+    };
+  }
+
+  public async request<T, R = T>(
     method: BaseApiMethods,
-    url: string,
-    query?: Record<string, unknown>
-  ): Promise<T> {
+    url: Path,
+    query?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R>> {
     try {
-      const response = await this.directus.request<T>(() => {
-        const params = JSON.stringify(query);
-        return {
-          path: `${url}?${params}`,
-          method: method
-        };
-      });
-      return response;
+      const { body, headers } = query || {};
+      const params = this.normalizeQuery(query);
+
+      const data = await this.directus.request<R>(
+        (() =>
+          ({
+            path: url,
+            method,
+            headers,
+            params,
+            ...(typeof body === 'undefined'
+              ? {}
+              : {
+                  body:
+                    body instanceof FormData || typeof body === 'string'
+                      ? body
+                      : JSON.stringify(body)
+                })
+          })) as never
+      );
+
+      return this.transformResponse({ data }, method === 'POST' ? 201 : method === 'DELETE' ? 202 : 200);
     } catch (error) {
       console.error(`Error request:`, error);
       throw error;
     }
   }
 
-  public async find<T, Q = T, R = T>(
+  public async find<T, F = T, R = T>(
     collection: Path,
-    query: ApiFindQuery<Q>
+    query: ApiFindQuery<F>,
+    config?: ApiAdapterRequestConfig
   ): Promise<ApiResponse<R[]>> {
-    const response = (await this.directus.request<T>(readItems(collection, query))) as R[];
-    const total = await this.includeTotals(collection, query);
+    const q = this.normalizeQuery(config, query as Q);
+    const data = await this.directus.request<R[]>(
+      readItems(collection as unknown as RegularCollections<Schema>, q as never)
+    );
+    const total = await this.includeTotals(collection, query, config);
+
     if (null === total) {
-      return this.transformResponse({ data: response });
+      return this.transformResponse({ data });
     }
-    // console.log('find meta', response, total)
 
-    return this.transformResponse({ data: response, meta: { total } });
+    return this.transformResponse({ data, meta: { total } });
   }
 
-  public async findOne<T>(
+  public async findOne<T, R = T>(
     collection: Path,
-    key?: ApiId,
-    query?: Record<string, unknown>
-  ): Promise<ApiResponse<T>> {
-    const data = await this.directus.request<T>(readItem(collection, key, query));
+    key: ApiId,
+    query?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R>> {
+    const q = this.normalizeQuery(query);
+    const data = await this.directus.request<R>(
+      readItem(collection as unknown as RegularCollections<Schema>, key, q as never)
+    );
     return this.transformResponse({ data });
   }
 
-  public async aggregate<T, Q = T, R = T>(
+  public async aggregate<T, F = T, R = T>(
     collection: Path,
-    query: ApiAggregateQuery<Q>
+    query: ApiAggregateQuery<F>,
+    config?: ApiAdapterRequestConfig
   ): Promise<ApiResponse<R>> {
-    const { aggregate: aggregate_, ...rest } = query || {};
-
-    const data = await this.directus.request<T>(
-      aggregate(collection, {
-        aggregate: aggregate_
-          ? aggregate_
-          : {
-              count: 'id'
-            },
+    const { aggregate: a, ...rest } = this.normalizeQuery(config, query as Q);
+
+    const data = await this.directus.request<R>(
+      aggregate(collection as unknown as AllCollections<Schema>, {
+        aggregate: a ? a : { count: 'id' },
         query: rest
-      })
+      } as never)
     );
 
     return this.transformResponse({ data });
   }
 
-  public async patch<T>(
+  public async patch<T extends object, R = T>(
     collection: Path,
     key: ApiId,
-    query?: Record<string, unknown>
-  ): Promise<ApiResponse<T>> {
-    const data = await this.directus.request<T>(updateItem(collection, key, query));
-    return this.transformResponse({ data });
+    data: ApiPatchQuery<T>,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R>> {
+    const q = this.normalizeQuery(config);
+    const res = await this.directus.request<R>(
+      updateItem(collection as never, key, data as never, q as never)
+    );
+    return this.transformResponse({ data: res });
   }
 
-  public async post<T>(
+  public async post<T extends object, R = T>(
     collection: Path,
-    data: AnyObject,
-    query?: Record<string, unknown>
-  ): Promise<ApiResponse<T>> {
-    const response = await this.directus.request<T>(createItem(collection, data, query));
-    return this.transformResponse({ data: response }, 201);
+    data: ApiPostQuery<T>,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R>> {
+    const q = this.normalizeQuery(config);
+    const res = await this.directus.request<R>(
+      createItem(collection as never, data as never, q as never)
+    );
+    return this.transformResponse({ data: res }, 201);
   }
 
-  public async delete<T>(collection: Path, key?: ApiId): Promise<ApiResponse<T>> {
-    const data = await this.directus.request<T>(deleteItem(collection, key));
+  public async delete<T, R = T>(
+    collection: Path,
+    key: ApiId,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R>> {
+    void config;
+    const data = await this.directus.request<R>(deleteItem(collection as never, key));
     return this.transformResponse({ data }, 202);
   }
 
   public async put<T extends object, R = T>(
     collection: Path,
-    key?: ApiId,
-    payload?: AnyObject,
-    query?: Record<string, unknown>
+    data: ApiPutQuery<T>,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R>>;
+  public async put<T extends object, R = T>(
+    collection: Path,
+    key: ApiId,
+    data?: AnyObject,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R>>;
+  public async put<T extends object, R = T>(
+    collection: Path,
+    keyOrData: ApiId | ApiPutQuery<T>,
+    dataOrConfig?: AnyObject | ApiAdapterRequestConfig,
+    config?: ApiAdapterRequestConfig
   ): Promise<ApiResponse<R>> {
-    if (key) {
-      const data = (await this.directus.request<T>(
-        updateItem(collection, key, payload, query)
-      )) as R;
-      return this.transformResponse({ data }, 201);
-    } else {
-      console.error(`Error updating all ${collection}: no key specified`);
+    const key =
+      typeof keyOrData === 'string' || typeof keyOrData === 'number'
+        ? keyOrData
+        : this.getId(keyOrData, dataOrConfig as ApiAdapterRequestConfig | undefined);
+    const data =
+      typeof keyOrData === 'string' || typeof keyOrData === 'number'
+        ? (dataOrConfig as AnyObject | undefined)
+        : keyOrData;
+    const q =
+      typeof keyOrData === 'string' || typeof keyOrData === 'number'
+        ? config
+        : (dataOrConfig as ApiAdapterRequestConfig | undefined);
+
+    if (!key) {
       throw new Error('No key specified');
     }
+
+    const res = await this.directus.request<R>(
+      updateItem(collection as never, key, data as never, this.normalizeQuery(this.stripId(q)) as never)
+    );
+
+    return this.transformResponse({ data: res }, 201);
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  public async upload<T>(path: string = '', data: FormData): Promise<ApiResponse<T>> {
-    const response = await this.directus.request<T>(uploadFiles(data));
-    return this.transformResponse({ data: response }, 201);
+  public async upload<T, R = T>(
+    path: Path,
+    data: FormData,
+    config?: ApiAdapterRequestConfig & { method?: BaseApiMethods }
+  ): Promise<ApiResponse<R>> {
+    void path;
+    void config;
+    const res = await this.directus.request<R>(uploadFiles(data));
+    return this.transformResponse({ data: res }, 201);
   }
 
-  async createMany<T, R = T>(path: Path, body: ApiCreateManyQuery<T>) {
-    const data = await this.directus.request<T>(createItems(path, body.data, body?.query));
-    return this.transformResponse<R[]>({ data }, 200);
+  async createMany<T, R = T>(
+    path: Path,
+    body: ApiCreateManyQuery<T>,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R[]>> {
+    const q = this.normalizeQuery(config, ((body as Q).query as Q | undefined) || {});
+    const data = await this.directus.request<R[]>(
+      createItems(path as never, body.data as never, q as never)
+    );
+    return this.transformResponse({ data }, 200);
   }
 
-  async updateMany<T, R = T>(path: Path, body: ApiUpdateManyQuery<T>) {
+  async updateMany<T, R = T>(
+    path: Path,
+    body: ApiUpdateManyQuery<T>,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R[]>> {
     if (!body.ids) {
       throw Error('You must provide an array of keys to update');
     }
-    const data = await this.directus.request<T>(
-      updateItems(path, body.ids || [], body.data, body?.query)
+
+    const q = this.normalizeQuery(config, ((body as Q).query as Q | undefined) || {});
+    const ids = body.ids as string[] | number[];
+    const data = await this.directus.request<R[]>(
+      updateItems(path as never, ids, body.data as never, q as never)
     );
-    return this.transformResponse<R[]>({ data }, 200);
+    return this.transformResponse({ data }, 200);
   }
 
-  async deleteMany<R = null>(path: Path, body: ApiDeleteManyQuery<ApiId>) {
-    const data = await this.directus.request(deleteItems(path, body.ids));
-    return this.transformResponse<R>({ data } as R, 201);
+  async deleteMany<R>(
+    path: Path,
+    body: ApiDeleteManyQuery<ApiId>,
+    config?: ApiAdapterRequestConfig
+  ): Promise<ApiResponse<R[]>> {
+    void config;
+    const ids = body.ids as string[] | number[];
+    const data = await this.directus.request<R[]>(deleteItems(path as never, ids));
+    return this.transformResponse({ data }, 201);
   }
 }

package/src/index.ts

@@ -7,3 +7,4 @@ export * from './services/register';
 export type * from './types';
 
 export * from './provider/api-references-functions.provider';
+export * from './utils/directus-error';

package/src/provider/api-adapter.provider.ts

@@ -1,17 +1,25 @@
 import type {
   AdapterProviderRegister,
+  ApiAdapterRequestConfig,
   ApiAdapterInterface,
   ApiAdapterProviderInterface
 } from '@tanglemedia/svelte-starter-core';
 import { DirectusApiAdapter } from '../adapter/api-adapter';
-import type { DirectusConfig, SchemaShape } from '../types/adapter.types';
+import type { DirectusAdapterClient, DirectusConfig, SchemaShape } from '../types/adapter.types';
 import { createDirectusClientFactory } from './directus.factory';
 
 export class DirectusApiProvider implements ApiAdapterProviderInterface<DirectusConfig> {
   async loadAdapter(
     key?: string,
     config?: DirectusConfig
-  ): Promise<ApiAdapterInterface<DirectusConfig>> {
+  ): Promise<
+    ApiAdapterInterface<
+      DirectusConfig,
+      ApiAdapterRequestConfig,
+      string,
+      DirectusAdapterClient<SchemaShape>
+    >
+  > {
     if (!config) {
       throw new Error('Missing adapter configuration');
     }
@@ -21,7 +29,7 @@ export class DirectusApiProvider implements ApiAdapterProviderInterface<Directus
     return new DirectusApiAdapter(config, client);
   }
 
-  createDirectusClient<T extends object>(config: DirectusConfig) {
+  createDirectusClient<T extends SchemaShape>(config: DirectusConfig): DirectusAdapterClient<T> {
     // todo: Determine if we can overwrite the fetch globals during runtime
     return createDirectusClientFactory<T>(config);
   }