@warp-drive/utilities 5.7.0-alpha.0 → 5.7.0-alpha.10

package/declarations/-private/active-record/find-record.d.ts

@@ -59,7 +59,7 @@ export type FindRecordResultDocument<T> = Omit<SingleResourceDataDocument<T>, "d
 * @param identifier
 * @param options
 */
-export declare function findRecord<T>(identifier: RemotelyAccessibleIdentifier<TypeFromInstance<T>>, options?: FindRecordOptions<T>): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
+export declare function findRecord<T>(identifier: RemotelyAccessibleIdentifier<TypeFromInstance<T>>, options?: FindRecordOptions): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
 export declare function findRecord(identifier: RemotelyAccessibleIdentifier, options?: FindRecordOptions): FindRecordRequestOptions;
-export declare function findRecord<T>(type: TypeFromInstance<T>, id: string, options?: FindRecordOptions<T>): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
+export declare function findRecord<T>(type: TypeFromInstance<T>, id: string, options?: FindRecordOptions): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
 export declare function findRecord(type: string, id: string, options?: FindRecordOptions): FindRecordRequestOptions;

package/declarations/-private/json-api/find-record.d.ts

@@ -59,7 +59,7 @@ import type { SingleResourceDataDocument } from "@warp-drive/core/types/spec/doc
 export type FindRecordResultDocument<T> = Omit<SingleResourceDataDocument<T>, "data"> & {
 	data: T;
 };
-export declare function findRecord<T>(identifier: RemotelyAccessibleIdentifier<TypeFromInstance<T>>, options?: FindRecordOptions<T>): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
+export declare function findRecord<T>(identifier: RemotelyAccessibleIdentifier<TypeFromInstance<T>>, options?: FindRecordOptions): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
 export declare function findRecord(identifier: RemotelyAccessibleIdentifier, options?: FindRecordOptions): FindRecordRequestOptions;
-export declare function findRecord<T>(type: TypeFromInstance<T>, id: string, options?: FindRecordOptions<T>): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
+export declare function findRecord<T>(type: TypeFromInstance<T>, id: string, options?: FindRecordOptions): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
 export declare function findRecord(type: string, id: string, options?: FindRecordOptions): FindRecordRequestOptions;

package/declarations/-private/json-api/query.d.ts

@@ -53,7 +53,7 @@ import type { CollectionResourceDataDocument } from "@warp-drive/core/types/spec
 * @param query
 * @param options
 */
-export declare function query<T extends TypedRecordInstance>(type: TypeFromInstance<T>, query?: QueryParamsSource<T>, options?: ConstrainedRequestOptions): QueryRequestOptions<CollectionResourceDataDocument<T>, T>;
+export declare function query<T extends TypedRecordInstance>(type: TypeFromInstance<T>, query?: QueryParamsSource, options?: ConstrainedRequestOptions): QueryRequestOptions<CollectionResourceDataDocument<T>, T>;
 export declare function query(type: string, query?: QueryParamsSource, options?: ConstrainedRequestOptions): QueryRequestOptions;
 /**
 * Builds request options to query for resources, usually by a primary

package/declarations/-private/rest/find-record.d.ts

@@ -59,7 +59,7 @@ import type { SingleResourceDataDocument } from "@warp-drive/core/types/spec/doc
 export type FindRecordResultDocument<T> = Omit<SingleResourceDataDocument<T>, "data"> & {
 	data: T;
 };
-export declare function findRecord<T>(identifier: RemotelyAccessibleIdentifier<TypeFromInstance<T>>, options?: FindRecordOptions<T>): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
+export declare function findRecord<T>(identifier: RemotelyAccessibleIdentifier<TypeFromInstance<T>>, options?: FindRecordOptions): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
 export declare function findRecord(identifier: RemotelyAccessibleIdentifier, options?: FindRecordOptions): FindRecordRequestOptions;
-export declare function findRecord<T>(type: TypeFromInstance<T>, id: string, options?: FindRecordOptions<T>): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
+export declare function findRecord<T>(type: TypeFromInstance<T>, id: string, options?: FindRecordOptions): FindRecordRequestOptions<FindRecordResultDocument<T>, T>;
 export declare function findRecord(type: string, id: string, options?: FindRecordOptions): FindRecordRequestOptions;

package/declarations/derivations.d.ts

@@ -0,0 +1,27 @@
+import type { ReactiveResource } from "@warp-drive/core/reactive";
+import { Type } from "@warp-drive/core/types/symbols";
+interface ConcatDerivation {
+	(record: ReactiveResource & {
+		[key: string]: unknown;
+	}, options: Record<string, unknown> | null, _prop: string): string;
+	[Type]: "concat";
+}
+/**
+* A derivation for use by {@link ReactiveResource} that joins the given fields
+* with the optional separator (or '' if no separator is provided).
+*
+* Generally you should not need to import and use this function directly.
+*
+* @example
+* {
+*   name: 'fullName',
+*   kind: 'derived',
+*   type: 'concat',
+*   options: {
+*     fields: ['firstName', 'lastName'],
+*     separator: ' ',
+*   },
+* }
+*/
+export declare const concat: ConcatDerivation;
+export {};

package/dist/derivations.js

@@ -0,0 +1,30 @@
+import { Type } from '@warp-drive/core/types/symbols';
+
+/**
+ * A derivation for use by {@link ReactiveResource} that joins the given fields
+ * with the optional separator (or '' if no separator is provided).
+ *
+ * Generally you should not need to import and use this function directly.
+ *
+ * @example
+ * {
+ *   name: 'fullName',
+ *   kind: 'derived',
+ *   type: 'concat',
+ *   options: {
+ *     fields: ['firstName', 'lastName'],
+ *     separator: ' ',
+ *   },
+ * }
+ */
+const concat = (record, options, _prop) => {
+  if (!options) {
+    throw new Error(`options is required`);
+  }
+  // SAFETY: we cast internally to a more specific type, for our own use
+  // SAFETY: but provide the more general signature to the schema service
+  const opts = options;
+  return opts.fields.map(field => record[field]).join(opts.separator ?? '');
+};
+concat[Type] = 'concat';
+export { concat };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warp-drive/utilities",
-  "version": "5.7.0-alpha.0",
+  "version": "5.7.0-alpha.10",
   "description": "Utilities package for WarpDrive | Things your app might find useful",
   "keywords": [
     "ember-addon"
@@ -36,7 +36,7 @@
     }
   },
   "peerDependencies": {
-    "@warp-drive/core": "5.7.0-alpha.0"
+    "@warp-drive/core": "5.7.0-alpha.10"
   },
   "dependencies": {
     "@embroider/macros": "^1.16.12"
@@ -45,8 +45,8 @@
     "@babel/core": "^7.26.10",
     "@babel/plugin-transform-typescript": "^7.27.0",
     "@babel/preset-typescript": "^7.27.0",
-    "@warp-drive/internal-config": "5.7.0-alpha.0",
-    "@warp-drive/core": "5.7.0-alpha.0",
+    "@warp-drive/internal-config": "5.7.0-alpha.10",
+    "@warp-drive/core": "5.7.0-alpha.10",
     "decorator-transforms": "^2.3.0",
     "expect-type": "^1.2.1",
     "typescript": "^5.8.3",