Found a bug. Anyways, here's the deal:

1. It's getting close to API stability.
2. After API stability come the UAT tests
   and the whole big gun quality control.
3. Once it's black-box tested inside & out
   we can finally clean up the code under
   the hood.
4. After cleanin' up, it'll be a release of
   version 1.0.0

next-rest/description/Delete.ts

@@ -2,7 +2,7 @@ import {ReadHandler} from '#handlers/ReadHandler';
 import {Identifier} from '#Identifier';
 import {Coded} from './Coded';
 import {Description} from './Description';
-import {IdentityAware} from './Identified';
+import {IdentityAware} from './IdentityAware';
 
 /**
  * @summary

next-rest/description/IdentityAware.ts

@@ -0,0 +1,38 @@
+import {Description} from '#description';
+
+/**
+ * @summary
+ * Describes an identified resource.
+ * @description
+ * Used for `Read` and `Delete` mostly but not exclusively.
+ * Apply this type for cases where you would want to support
+ * an identifier parameter.
+ * @group Core API
+ */
+export type IdentityAware = {
+  /**
+   * @summary
+   * The name of the identifier parameter.
+   * @description
+   * This is the name of the parameter that will be used to
+   * extract the resource's identifier from the NextJS request.
+   */
+  idParameterName: string;
+};
+
+/**
+ * @summary
+ * Determines if a description is identity aware.
+ * @param v The description to test.
+ * @returns True if the description is identity aware, false otherwise.
+ * @template R The type of the resource.
+ * @template I The type of the identifier.
+ * @template Q The type of the query.
+ * @group Core API
+ */
+export const isIdentityAware = <R, I, Q>(
+  v: Description<R, I, Q>
+): v is IdentityAware & Description<R, I, Q> => {
+  const candidate = v as IdentityAware;
+  return typeof candidate.idParameterName === 'string';
+};

next-rest/description/Read.ts

@@ -2,7 +2,7 @@ import {ReadHandler} from '#handlers/ReadHandler';
 import {Identifier} from '#Identifier';
 import {Coded} from './Coded';
 import {Description} from './Description';
-import {IdentityAware} from './Identified';
+import {IdentityAware} from './IdentityAware';
 
 /**
  * @summary

next-rest/description/Update.ts

@@ -2,7 +2,7 @@ import {Identifier} from '#Identifier';
 import {UpdateHandler} from '#handlers/UpdateHandler';
 import {Coded} from './Coded';
 import {Description} from './Description';
-import {IdentityAware} from './Identified';
+import {IdentityAware} from './IdentityAware';
 
 /**
  * @summary

next-rest/description/index.ts

@@ -4,6 +4,6 @@ export * from './ReadSet';
 export * from './Update';
 export * from './Delete';
 export * from './Queried';
-export * from './Identified';
+export * from './IdentityAware';
 export * from './Description';
 export * from './Coded';

next-rest/handler.ts

@@ -2,6 +2,7 @@ import {
   Description,
   IdentityAware,
   isDeletable,
+  isIdentityAware,
   isReadable,
   isReadSetable,
   isUpdatable,
@@ -22,7 +23,11 @@ export const handler: Handler = description => async (request, response) => {
     return response.status(400).end();
   if (!isHttpMethod(request.method)) return response.status(405).end();
 
-  const isSingular = 'id' in request.query;
+  const queryKeys = Object.keys(request.query);
+  const isSingular =
+    isIdentityAware(description) &&
+    queryKeys.length === 1 &&
+    queryKeys[0] === description.idParameterName;
 
   if (request.method === 'GET') {
     if (isSingular) {

test/unit/handler.test.ts

@@ -106,7 +106,10 @@ describe('handler', () => {
       it.each(combine([readSetable, creatable, updatable, deletable]))(
         'Should respond with a status 405 when the parameter count is one but it is not a Readable resource',
         (descriptor: any) => {
-          handler(descriptor)({...request, query: {test: 1}}, mockResponse);
+          handler({...descriptor, idParameterName: 'test'})(
+            {...request, query: {test: 1}},
+            mockResponse
+          );
           expect(readHandler).not.toHaveBeenCalled();
           expect(readSetHandler).not.toHaveBeenCalled();
           expect(createHandler).not.toHaveBeenCalled();