@codecks/fetch 0.1.6 → 0.1.8

package/dist/_exploration/api-requester.d.ts

@@ -1,7 +1,7 @@
-import "../query-type-B0L3hwCo.js";
-import "../index-obQtSRRg.js";
-import { FetchOptions } from "../loader-utils-rQFSDhwf.js";
-import { BaseRequester, MissingDataRequest } from "../loader-types-Y0OHlOEK.js";
+import "../query-type-BqQ9oX_U.js";
+import "../index-k-KPWV9R.js";
+import { FetchOptions } from "../loader-utils-BqZKAn_v.js";
+import { BaseRequester, MissingDataRequest } from "../loader-types-fd5tV0FD.js";
 
 //#region src/_exploration/api-requester.d.ts
 declare class ApiRequester implements BaseRequester {

package/dist/_exploration/api-requester.js

@@ -1,5 +1,5 @@
 import { configuredFetch, ensureMapValue } from "../collection-utils-CYJaA1a9.js";
-import { serializeModel } from "../query-helpers-DgC42MEH.js";
+import { serializeModel } from "../query-helpers-iX1fiqLv.js";
 
 //#region src/_exploration/utils/concurrency-limiter.ts
 var ConcurrencyLimiter = class {
@@ -108,11 +108,23 @@ var ApiRequester = class {
 			key: "",
 			partialInstance: instances
 		});
-		else for (const [id, data] of Object.entries(instances)) results.push({
-			model: modelName,
-			key: id,
-			partialInstance: data
-		});
+		else for (const [id, data] of Object.entries(instances)) {
+			if (data == null) {
+				const requested = dataByModel.get(modelName)?.get(id);
+				if (!requested) continue;
+				results.push({
+					model: modelName,
+					key: id,
+					partialInstance: Object.fromEntries([...requested.fields, ...requested.relations.keys()].map((key) => [key, null]))
+				});
+				continue;
+			}
+			results.push({
+				model: modelName,
+				key: id,
+				partialInstance: data
+			});
+		}
 		return results;
 	}
 };

package/dist/_exploration/create-hooks.d.ts

@@ -1,8 +1,8 @@
-import { InferModelQuery, InferRelQuery, ModelDesc, ModelQuery, RelQuery, RelationEntry, TypedField } from "../query-type-B0L3hwCo.js";
-import { AccountId, AccountOnboardingStepId, ActiveTimeTrackerId, ActivityId, AffiliateCodeId, AppId, AppInstallationId, AttachmentId, CardId, CardPresetId, CardSubscriptionId, CardUpvoteId, DeckId, DeckSubscriptionId, DiscordGuildId, DiscordMemberId, DiscordProjectNotificationId, DiscordSlashCommandId, FileId, IntegrationId, InvoiceId, MilestoneId, PinnedMilestoneId, ProjectId, ProjectSelectionId, ProjectTagId, QueueEntryId, QueueSelectionId, ReleaseId, ResolvableEntryId, ResolvableEntryReactionId, ResolvableId, SavedSearchId, SprintConfigId, SprintId, TimeTrackingSegmentId, UserEmailId, UserId, UserInvitationId, UserInviteCodeId, UserReportEmailId, UserReportSettingId, UserReportTokenId, UserTagId, VisionBoardId, VisionBoardQueryId, WizardId, WorkflowItemId } from "../index-obQtSRRg.js";
-import "../loader-types-Y0OHlOEK.js";
-import { _rootDesc$1 as _rootDesc } from "../_root-rBEjvjCJ.js";
-import { Store } from "../store-LSWKTuHv.js";
+import { InferModelQuery, InferRelQuery, ModelDesc, ModelQuery, RelQuery, RelationEntry, TypedField } from "../query-type-BqQ9oX_U.js";
+import { AccountId, AccountOnboardingStepId, ActiveTimeTrackerId, ActivityId, AffiliateCodeId, AppId, AppInstallationId, AttachmentId, CardId, CardPresetId, CardSubscriptionId, CardUpvoteId, DeckId, DeckSubscriptionId, DiscordGuildId, DiscordMemberId, DiscordProjectNotificationId, DiscordSlashCommandId, FileId, IntegrationId, InvoiceId, MilestoneId, PinnedMilestoneId, ProjectId, ProjectSelectionId, ProjectTagId, QueueEntryId, QueueSelectionId, ReleaseId, ResolvableEntryId, ResolvableEntryReactionId, ResolvableId, SavedSearchId, SprintConfigId, SprintId, TimeTrackingSegmentId, UserEmailId, UserId, UserInvitationId, UserInviteCodeId, UserReportEmailId, UserReportSettingId, UserReportTokenId, UserTagId, VisionBoardId, VisionBoardQueryId, WizardId, WorkflowItemId } from "../index-k-KPWV9R.js";
+import "../loader-types-fd5tV0FD.js";
+import { _rootDesc$1 as _rootDesc } from "../_root-BW9uzB79.js";
+import { Store } from "../store-BvEJzUVp.js";
 
 //#region src/_exploration/create-hooks.d.ts
 declare const createHooks: (store: Store) => {
@@ -808,6 +808,7 @@ declare const createHooks: (store: Store) => {
       }>;
       attachments: RelationEntry<"attachment", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       diffs: RelationEntry<"cardHistory", {
         readonly type: "hasMany";
@@ -820,15 +821,19 @@ declare const createHooks: (store: Store) => {
       }>;
       childCards: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       inDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       cardReferences: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       upvotes: RelationEntry<"cardUpvote", {
         readonly type: "hasMany";
@@ -2524,9 +2529,11 @@ declare const createHooks: (store: Store) => {
       }>;
       inDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
     }, ["itemId"]>;
   }[K], {
@@ -3331,6 +3338,7 @@ declare const createHooks: (store: Store) => {
       }>;
       attachments: RelationEntry<"attachment", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       diffs: RelationEntry<"cardHistory", {
         readonly type: "hasMany";
@@ -3343,15 +3351,19 @@ declare const createHooks: (store: Store) => {
       }>;
       childCards: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       inDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       cardReferences: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       upvotes: RelationEntry<"cardUpvote", {
         readonly type: "hasMany";
@@ -5047,9 +5059,11 @@ declare const createHooks: (store: Store) => {
       }>;
       inDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
     }, ["itemId"]>;
   }>>(model: K, id: Id, q: Q) => InferModelQuery<{
@@ -5854,6 +5868,7 @@ declare const createHooks: (store: Store) => {
       }>;
       attachments: RelationEntry<"attachment", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       diffs: RelationEntry<"cardHistory", {
         readonly type: "hasMany";
@@ -5866,15 +5881,19 @@ declare const createHooks: (store: Store) => {
       }>;
       childCards: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       inDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       cardReferences: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       upvotes: RelationEntry<"cardUpvote", {
         readonly type: "hasMany";
@@ -7570,9 +7589,11 @@ declare const createHooks: (store: Store) => {
       }>;
       inDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
     }, ["itemId"]>;
   }[K], Q, {
@@ -8377,6 +8398,7 @@ declare const createHooks: (store: Store) => {
       }>;
       attachments: RelationEntry<"attachment", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       diffs: RelationEntry<"cardHistory", {
         readonly type: "hasMany";
@@ -8389,15 +8411,19 @@ declare const createHooks: (store: Store) => {
       }>;
       childCards: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       inDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       cardReferences: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       upvotes: RelationEntry<"cardUpvote", {
         readonly type: "hasMany";
@@ -10093,9 +10119,11 @@ declare const createHooks: (store: Store) => {
       }>;
       inDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
     }, ["itemId"]>;
   }>;
@@ -10901,6 +10929,7 @@ declare const createHooks: (store: Store) => {
       }>;
       attachments: RelationEntry<"attachment", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       diffs: RelationEntry<"cardHistory", {
         readonly type: "hasMany";
@@ -10913,15 +10942,19 @@ declare const createHooks: (store: Store) => {
       }>;
       childCards: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       inDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       cardReferences: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       upvotes: RelationEntry<"cardUpvote", {
         readonly type: "hasMany";
@@ -12617,9 +12650,11 @@ declare const createHooks: (store: Store) => {
       }>;
       inDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
     }, ["itemId"]>;
   }>>(q: Q) => InferRelQuery<typeof _rootDesc, Q, {
@@ -13424,6 +13459,7 @@ declare const createHooks: (store: Store) => {
       }>;
       attachments: RelationEntry<"attachment", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       diffs: RelationEntry<"cardHistory", {
         readonly type: "hasMany";
@@ -13436,15 +13472,19 @@ declare const createHooks: (store: Store) => {
       }>;
       childCards: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       inDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       cardReferences: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       upvotes: RelationEntry<"cardUpvote", {
         readonly type: "hasMany";
@@ -15140,9 +15180,11 @@ declare const createHooks: (store: Store) => {
       }>;
       inDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
     }, ["itemId"]>;
   }>;

package/dist/_exploration/create-hooks.js

@@ -1,4 +1,4 @@
-import { queryToKey } from "../query-helpers-DgC42MEH.js";
+import { queryToKey } from "../query-helpers-iX1fiqLv.js";
 import { getFieldKey } from "../immediate-cache-DiH8tpJM.js";
 import { use, useSyncExternalStore } from "react";
 

package/dist/_exploration/loader.d.ts

@@ -1,5 +1,5 @@
-import "../query-type-B0L3hwCo.js";
-import { BaseLoader, BaseRequester, MissingDataRequest, OnLoadedFn } from "../loader-types-Y0OHlOEK.js";
+import "../query-type-BqQ9oX_U.js";
+import { BaseLoader, BaseRequester, MissingDataRequest, OnLoadedFn } from "../loader-types-fd5tV0FD.js";
 
 //#region src/_exploration/loader.d.ts
 type DataRequestWithKey = {

package/dist/_exploration/loader.js

@@ -1,4 +1,4 @@
-import { serializeModel } from "../query-helpers-DgC42MEH.js";
+import { serializeModel } from "../query-helpers-iX1fiqLv.js";
 
 //#region src/_exploration/loader.ts
 const notYetLoaded = () => {

package/dist/_exploration/store.d.ts

@@ -1,5 +1,5 @@
-import "../query-type-B0L3hwCo.js";
-import "../index-obQtSRRg.js";
-import "../loader-types-Y0OHlOEK.js";
-import { Store } from "../store-LSWKTuHv.js";
+import "../query-type-BqQ9oX_U.js";
+import "../index-k-KPWV9R.js";
+import "../loader-types-fd5tV0FD.js";
+import { Store } from "../store-BvEJzUVp.js";
 export { Store };

package/dist/_exploration/store.js

@@ -1,4 +1,4 @@
-import { getRelKey, makeRelQuerySerializable, modelMap } from "../query-helpers-DgC42MEH.js";
+import { getRelKey, makeRelQuerySerializable, modelMap } from "../query-helpers-iX1fiqLv.js";
 import { ImmediateCache } from "../immediate-cache-DiH8tpJM.js";
 
 //#region src/_exploration/store.ts
@@ -118,6 +118,9 @@ var Store = class {
 						data[`~${fieldName}`] = cachedValue.value.map((v) => `${v}`);
 						data[fieldName] = relationResults.map((result) => result.data);
 						if (relationResults.some((result) => !result.allPresent)) allPresent = false;
+					} else if (cachedValue.value == null) {
+						data[`~${fieldName}`] = null;
+						data[fieldName] = null;
 					} else {
 						const relationResult = this.checkQueryRecursive(relatedModelDesc, relatedModel, `${cachedValue.value}`, relQuery, missingRequests, acceptDirty);
 						data[`~${fieldName}`] = cachedValue.value != null ? `${cachedValue.value}` : null;

package/dist/{_root-rBEjvjCJ.d.ts → _root-BW9uzB79.d.ts}

@@ -1,4 +1,4 @@
-import { ModelDesc, RelationEntry } from "./query-type-B0L3hwCo.js";
+import { ModelDesc, RelationEntry } from "./query-type-BqQ9oX_U.js";
 
 //#region src/models/_root.d.ts
 declare const _rootDesc: ModelDesc<"_root", {}, {

package/dist/{index-obQtSRRg.d.ts → index-k-KPWV9R.d.ts}

@@ -1,4 +1,4 @@
-import { ModelDesc, Nominal, RelationEntry, TypedField } from "./query-type-B0L3hwCo.js";
+import { ModelDesc, Nominal, RelationEntry, TypedField } from "./query-type-BqQ9oX_U.js";
 
 //#region src/models/AccountOnboardingStep.d.ts
 type AccountOnboardingStepId = Nominal<string, "accountOnboardingStep">;
@@ -947,6 +947,7 @@ declare const modelMap: {
     }>;
     attachments: RelationEntry<"attachment", {
       readonly type: "hasMany";
+      readonly fkAsArray: true;
     }>;
     diffs: RelationEntry<"cardHistory", {
       readonly type: "hasMany";
@@ -959,15 +960,19 @@ declare const modelMap: {
     }>;
     childCards: RelationEntry<"card", {
       readonly type: "hasMany";
+      readonly fkAsArray: true;
     }>;
     inDeps: RelationEntry<"card", {
       readonly type: "hasMany";
+      readonly fkAsArray: true;
     }>;
     outDeps: RelationEntry<"card", {
       readonly type: "hasMany";
+      readonly fkAsArray: true;
     }>;
     cardReferences: RelationEntry<"card", {
       readonly type: "hasMany";
+      readonly fkAsArray: true;
     }>;
     upvotes: RelationEntry<"cardUpvote", {
       readonly type: "hasMany";
@@ -2663,9 +2668,11 @@ declare const modelMap: {
     }>;
     inDeps: RelationEntry<"workflowItem", {
       readonly type: "hasMany";
+      readonly fkAsArray: true;
     }>;
     outDeps: RelationEntry<"workflowItem", {
       readonly type: "hasMany";
+      readonly fkAsArray: true;
     }>;
   }, ["itemId"]>;
 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { InferModelQuery, InferRelQuery, Instance, ModelQuery, RelQuery } from "./query-type-B0L3hwCo.js";
-import { modelMap$1 as modelMap } from "./index-obQtSRRg.js";
-import { DataLoader, FetchOptions } from "./loader-utils-rQFSDhwf.js";
-import { _rootDesc$1 as _rootDesc } from "./_root-rBEjvjCJ.js";
+import { InferModelQuery, InferRelQuery, Instance, ModelQuery, RelQuery } from "./query-type-BqQ9oX_U.js";
+import { modelMap$1 as modelMap } from "./index-k-KPWV9R.js";
+import { DataLoader, FetchOptions } from "./loader-utils-BqZKAn_v.js";
+import { _rootDesc$1 as _rootDesc } from "./_root-BW9uzB79.js";
 
 //#region src/loaders/simple-loader.d.ts
 type SimpleLoaderOptions = FetchOptions;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { configuredFetch, ensureMapValue } from "./collection-utils-CYJaA1a9.js";
-import { _rootDesc, getRelKey, makeModelQuerySerializable, modelMap, serializeInstanceQuery } from "./query-helpers-DgC42MEH.js";
+import { _rootDesc, getRelKey, makeModelQuerySerializable, modelMap, serializeInstanceQuery } from "./query-helpers-iX1fiqLv.js";
 
 //#region src/model-pool.ts
 const ROOT_ID = "";
@@ -41,6 +41,7 @@ var ModelPool = class {
 		Object.entries(data).forEach(([modelName, payload]) => {
 			if (modelName === _rootDesc.name) this.addModelInstance(modelName, ROOT_ID, payload);
 			else Object.entries(payload).forEach(([id, payload$1]) => {
+				if (payload$1 == null) return;
 				this.addModelInstance(modelName, id, payload$1);
 			});
 		});
@@ -53,10 +54,16 @@ var ModelPool = class {
 
 //#endregion
 //#region src/reconcile-query.ts
+/**
+* The API names an id but answers `null` for it when the token may not read that
+* record. Such an id never enters the pool, and the caller can do nothing about it —
+* unlike an id the response never mentioned at all, which points at a bug worth a warning.
+*/
+const isWithheldByApi = (response, model, key) => response[model]?.[key] === null;
 const reconcileInstanceQuery = (query, response, instanceModel, key, store) => {
 	const instance = store.get(instanceModel.name, key);
 	if (!instance) {
-		console.warn(`no instance found in pool: [${instanceModel.name}, ${key}]`);
+		if (!isWithheldByApi(response, instanceModel.name, key)) console.warn(`no instance found in pool: [${instanceModel.name}, ${key}]`);
 		return null;
 	}
 	const result = instanceModel.name === "_root" ? {} : {
@@ -80,7 +87,7 @@ const reconcileInstanceQuery = (query, response, instanceModel, key, store) => {
 					break;
 				case "hasOne":
 					result[`~${relName}`] = instance[relName] != null ? `${instance[relName]}` : null;
-					result[relName] = reconcileInstanceQuery(relEntry, response, relModel, `${instance[relName]}`, store);
+					result[relName] = instance[relName] != null ? reconcileInstanceQuery(relEntry, response, relModel, `${instance[relName]}`, store) : null;
 					break;
 				case "hasMany":
 					const asName = relEntry.as ?? relName;
@@ -94,11 +101,20 @@ const reconcileInstanceQuery = (query, response, instanceModel, key, store) => {
 						}
 						case "first":
 							result[`~${asName}`] = val != null ? `${val}` : null;
-							result[asName] = reconcileInstanceQuery(relEntry, response, relModel, `${val}`, store);
+							result[asName] = val != null ? reconcileInstanceQuery(relEntry, response, relModel, `${val}`, store) : null;
 							break;
 						default: {
-							result[`~${asName}`] = val.map((v) => `${v}`);
-							result[asName] = val.map((id) => reconcileInstanceQuery(relEntry, response, relModel, `${id}`, store));
+							const ids = val ?? [];
+							const members = [];
+							for (const id of ids) {
+								const instance$1 = reconcileInstanceQuery(relEntry, response, relModel, `${id}`, store);
+								if (instance$1 != null) members.push({
+									key: `${id}`,
+									instance: instance$1
+								});
+							}
+							result[`~${asName}`] = members.map((m) => m.key);
+							result[asName] = members.map((m) => m.instance);
 						}
 					}
 					break;

package/dist/{loader-types-Y0OHlOEK.d.ts → loader-types-fd5tV0FD.d.ts}

@@ -1,4 +1,4 @@
-import { SerializableRelationQuery } from "./query-type-B0L3hwCo.js";
+import { SerializableRelationQuery } from "./query-type-BqQ9oX_U.js";
 
 //#region src/_exploration/loader-types.d.ts
 type OnLoadedFn = (model: string, key: string, partialInstance: Record<string, unknown>) => void;

package/dist/{loader-utils-rQFSDhwf.d.ts → loader-utils-BqZKAn_v.d.ts}

@@ -1,5 +1,5 @@
-import { InferModelQuery, ModelQuery } from "./query-type-B0L3hwCo.js";
-import { modelMap$1 as modelMap } from "./index-obQtSRRg.js";
+import { InferModelQuery, ModelQuery } from "./query-type-BqQ9oX_U.js";
+import { modelMap$1 as modelMap } from "./index-k-KPWV9R.js";
 
 //#region src/loaders/loader-utils.d.ts
 type ModelMap = typeof modelMap;

package/dist/{query-helpers-DgC42MEH.js → query-helpers-iX1fiqLv.js}

@@ -750,8 +750,14 @@ const workflowItemDesc = makeModel({
 			fk: "creatorId"
 		}),
 		diffs: relation("workflowItemHistory", { type: "hasMany" }),
-		inDeps: relation("workflowItem", { type: "hasMany" }),
-		outDeps: relation("workflowItem", { type: "hasMany" })
+		inDeps: relation("workflowItem", {
+			type: "hasMany",
+			fkAsArray: true
+		}),
+		outDeps: relation("workflowItem", {
+			type: "hasMany",
+			fkAsArray: true
+		})
 	},
 	keys: ["itemId"]
 });
@@ -915,14 +921,29 @@ const cardDesc = makeModel({
 		cardOrders: relation("cardOrder", { type: "hasMany" }),
 		resolvableEntries: relation("resolvableEntry", { type: "hasMany" }),
 		queueEntries: relation("queueEntry", { type: "hasMany" }),
-		attachments: relation("attachment", { type: "hasMany" }),
+		attachments: relation("attachment", {
+			type: "hasMany",
+			fkAsArray: true
+		}),
 		diffs: relation("cardHistory", { type: "hasMany" }),
 		totalTimeTrackingSums: relation("timeTrackingSum", { type: "hasOne" }),
 		userTimeTrackingSums: relation("timeTrackingSum", { type: "hasMany" }),
-		childCards: relation("card", { type: "hasMany" }),
-		inDeps: relation("card", { type: "hasMany" }),
-		outDeps: relation("card", { type: "hasMany" }),
-		cardReferences: relation("card", { type: "hasMany" }),
+		childCards: relation("card", {
+			type: "hasMany",
+			fkAsArray: true
+		}),
+		inDeps: relation("card", {
+			type: "hasMany",
+			fkAsArray: true
+		}),
+		outDeps: relation("card", {
+			type: "hasMany",
+			fkAsArray: true
+		}),
+		cardReferences: relation("card", {
+			type: "hasMany",
+			fkAsArray: true
+		}),
 		upvotes: relation("cardUpvote", { type: "hasMany" })
 	},
 	keys: ["cardId"]

package/dist/{query-type-B0L3hwCo.d.ts → query-type-BqQ9oX_U.d.ts}

@@ -33,6 +33,7 @@ type BelongsToOpts<TFk extends string> = {
 };
 type HasManyOpts = {
   type: "hasMany";
+  fkAsArray?: boolean;
 };
 type HasOneOpts = {
   type: "hasOne";
@@ -95,14 +96,26 @@ interface ModelQuery<T extends AnyDesc, TMap extends ModelMap> {
   fields?: (keyof T["fields"] & string)[];
   relations?: RelQuery<T, TMap>;
 }
-interface SimpleHasManyQuery<T extends AnyDesc, TMap extends ModelMap> extends ModelQuery<T, TMap> {
+interface BaseHasManyQuery<T extends AnyDesc, TMap extends ModelMap> extends ModelQuery<T, TMap> {
   type?: "query";
-  orderBy?: Order<T>;
-  limit?: number;
-  offset?: number;
   filter?: Filter<T, TMap>;
   as?: string;
 }
+/**
+ * A `limit`/`offset` "subset" requires an `orderBy` server-side (otherwise the
+ * API rejects the query with "needs an order ... to be able to use subset"), and
+ * `offset` is only meaningful together with `limit`. The union below makes the
+ * omission a compile error instead of a runtime 500.
+ */
+type SimpleHasManyQuery<T extends AnyDesc, TMap extends ModelMap> = BaseHasManyQuery<T, TMap> & ({
+  orderBy?: Order<T>;
+  limit?: never;
+  offset?: never;
+} | {
+  orderBy: Order<T>;
+  limit: number;
+  offset?: number;
+});
 interface CountOrExistQuery<T extends AnyDesc, TMap extends ModelMap> {
   type: "count" | "exists";
   filter?: Filter<T, TMap>;
@@ -117,6 +130,30 @@ interface FirstOrLastQuery<T extends AnyDesc, TMap extends ModelMap> extends Mod
   orderBy: Order<T>;
 }
 type HasManyQuery<T extends AnyDesc, TMap extends ModelMap> = SimpleHasManyQuery<T, TMap> | CountOrExistQuery<T, TMap> | FirstOrLastQuery<T, TMap>;
+/**
+ * `fkAsArray` hasMany relations (e.g. card `childCards`/`inDeps`/`outDeps`/
+ * `cardReferences`/`attachments`, workflowItem `inDeps`/`outDeps`) are stored as
+ * a plain id array column server-side. They support only plain selection
+ * (`fields` + nested `relations`) and the `count`/`exists` aggregates — any
+ * relQuery modifier (`filter`, `orderBy`, `limit`, `offset`, `type: "first"`) is
+ * rejected at runtime ("doesn't support relQueries"). The types mirror that.
+ */
+interface FkAsArrayQuery<T extends AnyDesc, TMap extends ModelMap> extends ModelQuery<T, TMap> {
+  type?: "query";
+  as?: string;
+  orderBy?: never;
+  limit?: never;
+  offset?: never;
+  filter?: never;
+}
+interface FkAsArrayCountOrExistQuery {
+  type: "count" | "exists";
+  as: string;
+  fields?: never;
+  relations?: never;
+  filter?: never;
+}
+type FkAsArrayHasManyQuery<T extends AnyDesc, TMap extends ModelMap> = FkAsArrayQuery<T, TMap> | FkAsArrayCountOrExistQuery;
 type AbstractHasManyQuery = (ModelQuery<any, any> & {
   type?: "query" | "first";
   as?: string;
@@ -127,7 +164,12 @@ type AbstractHasManyQuery = (ModelQuery<any, any> & {
 type HasManyQueryWithAs<T extends AnyDesc, TMap extends ModelMap> = HasManyQuery<T, TMap> & {
   as: string;
 };
-type HasManyRelQueryEntry<T extends AnyDesc, TMap extends ModelMap, K extends keyof ExtractHasMany<T, TMap>> = HasManyQuery<TMap[T["relations"][K]["relName"]], TMap> | HasManyQueryWithAs<TMap[T["relations"][K]["relName"]], TMap>[];
+type FkAsArrayHasManyQueryWithAs<T extends AnyDesc, TMap extends ModelMap> = FkAsArrayHasManyQuery<T, TMap> & {
+  as: string;
+};
+type HasManyRelQueryEntry<T extends AnyDesc, TMap extends ModelMap, K extends keyof ExtractHasMany<T, TMap>> = ExtractHasMany<T, TMap>[K] extends {
+  fkAsArray: true;
+} ? FkAsArrayHasManyQuery<ExtractHasMany<T, TMap>[K]["model"], TMap> | FkAsArrayHasManyQueryWithAs<ExtractHasMany<T, TMap>[K]["model"], TMap>[] : HasManyQuery<ExtractHasMany<T, TMap>[K]["model"], TMap> | HasManyQueryWithAs<ExtractHasMany<T, TMap>[K]["model"], TMap>[];
 type RelQueryEntry<T extends AnyDesc, TMap extends ModelMap, K extends keyof T["relations"]> = K extends keyof ExtractHasMany<T, TMap> ? HasManyRelQueryEntry<T, TMap, K> : ModelQuery<TMap[T["relations"][K]["relName"]], TMap>;
 /**
  * examples for account:
@@ -145,11 +187,14 @@ type EnrichBelongsTo<M extends AnyDesc, TMap extends ModelMap> = FilterNeverKeys
     type: FieldType;
   } & FieldOpts : never;
 } : never : never }>;
-type ExtractHasMany<M extends AnyDesc, TMap extends ModelMap> = FilterNeverKeys<{ [K in keyof M["relations"]]: M["relations"][K] extends RelationEntry<infer RelName, {
+type ExtractHasMany<M extends AnyDesc, TMap extends ModelMap> = FilterNeverKeys<{ [K in keyof M["relations"]]: M["relations"][K] extends RelationEntry<infer RelName, infer Opts> ? Opts extends {
   type: "hasMany";
-}> ? {
+} ? {
   model: TMap[RelName];
-} : never }>;
+  fkAsArray: Opts extends {
+    fkAsArray: true;
+  } ? true : false;
+} : never : never }>;
 type ExtractHasOne<M extends AnyDesc, TMap extends ModelMap> = FilterNeverKeys<{ [K in keyof M["relations"]]: M["relations"][K] extends RelationEntry<infer RelName, {
   type: "hasOne";
 }> ? {

package/dist/{store-LSWKTuHv.d.ts → store-BvEJzUVp.d.ts}

@@ -1,6 +1,6 @@
-import { ModelDesc, ModelQuery, RelationEntry, TypedField } from "./query-type-B0L3hwCo.js";
-import { AccountId, AccountOnboardingStepId, ActiveTimeTrackerId, ActivityId, AffiliateCodeId, AppId, AppInstallationId, AttachmentId, CardId, CardPresetId, CardSubscriptionId, CardUpvoteId, DeckId, DeckSubscriptionId, DiscordGuildId, DiscordMemberId, DiscordProjectNotificationId, DiscordSlashCommandId, FileId, IntegrationId, InvoiceId, MilestoneId, PinnedMilestoneId, ProjectId, ProjectSelectionId, ProjectTagId, QueueEntryId, QueueSelectionId, ReleaseId, ResolvableEntryId, ResolvableEntryReactionId, ResolvableId, SavedSearchId, SprintConfigId, SprintId, TimeTrackingSegmentId, UserEmailId, UserId, UserInvitationId, UserInviteCodeId, UserReportEmailId, UserReportSettingId, UserReportTokenId, UserTagId, VisionBoardId, VisionBoardQueryId, WizardId, WorkflowItemId, modelMap$1 as modelMap } from "./index-obQtSRRg.js";
-import { BaseLoader, LoaderResult, MissingDataRequest } from "./loader-types-Y0OHlOEK.js";
+import { ModelDesc, ModelQuery, RelationEntry, TypedField } from "./query-type-BqQ9oX_U.js";
+import { AccountId, AccountOnboardingStepId, ActiveTimeTrackerId, ActivityId, AffiliateCodeId, AppId, AppInstallationId, AttachmentId, CardId, CardPresetId, CardSubscriptionId, CardUpvoteId, DeckId, DeckSubscriptionId, DiscordGuildId, DiscordMemberId, DiscordProjectNotificationId, DiscordSlashCommandId, FileId, IntegrationId, InvoiceId, MilestoneId, PinnedMilestoneId, ProjectId, ProjectSelectionId, ProjectTagId, QueueEntryId, QueueSelectionId, ReleaseId, ResolvableEntryId, ResolvableEntryReactionId, ResolvableId, SavedSearchId, SprintConfigId, SprintId, TimeTrackingSegmentId, UserEmailId, UserId, UserInvitationId, UserInviteCodeId, UserReportEmailId, UserReportSettingId, UserReportTokenId, UserTagId, VisionBoardId, VisionBoardQueryId, WizardId, WorkflowItemId, modelMap$1 as modelMap } from "./index-k-KPWV9R.js";
+import { BaseLoader, LoaderResult, MissingDataRequest } from "./loader-types-fd5tV0FD.js";
 
 //#region src/_exploration/optimistic-manager.d.ts
 
@@ -898,6 +898,7 @@ declare class Store {
       }>;
       attachments: RelationEntry<"attachment", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       diffs: RelationEntry<"cardHistory", {
         readonly type: "hasMany";
@@ -910,15 +911,19 @@ declare class Store {
       }>;
       childCards: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       inDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       cardReferences: RelationEntry<"card", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       upvotes: RelationEntry<"cardUpvote", {
         readonly type: "hasMany";
@@ -2614,9 +2619,11 @@ declare class Store {
       }>;
       inDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
       outDeps: RelationEntry<"workflowItem", {
         readonly type: "hasMany";
+        readonly fkAsArray: true;
       }>;
     }, ["itemId"]>;
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codecks/fetch",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Quickly create deeply nested queries for the Codecks API with advanced TypeScript support",
   "type": "module",
   "license": "MIT",

package/schema/models/card.md

@@ -72,11 +72,11 @@ Key: `cardId`
 - `cardOrders` → [cardOrder](cardOrder.md)
 - `resolvableEntries` → [resolvableEntry](resolvableEntry.md)
 - `queueEntries` → [queueEntry](queueEntry.md)
-- `attachments` → [attachment](attachment.md)
+- `attachments` → [attachment](attachment.md) — `fkAsArray` (plain selection + `count`/`exists` only; no `filter`/`orderBy`/`limit`/`offset`/`first`)
 - `diffs` → [cardHistory](cardHistory.md)
 - `userTimeTrackingSums` → [timeTrackingSum](timeTrackingSum.md)
-- `childCards` → [card](card.md)
-- `inDeps` → [card](card.md)
-- `outDeps` → [card](card.md)
-- `cardReferences` → [card](card.md)
+- `childCards` → [card](card.md) — `fkAsArray` (plain selection + `count`/`exists` only; no `filter`/`orderBy`/`limit`/`offset`/`first`)
+- `inDeps` → [card](card.md) — `fkAsArray` (plain selection + `count`/`exists` only; no `filter`/`orderBy`/`limit`/`offset`/`first`)
+- `outDeps` → [card](card.md) — `fkAsArray` (plain selection + `count`/`exists` only; no `filter`/`orderBy`/`limit`/`offset`/`first`)
+- `cardReferences` → [card](card.md) — `fkAsArray` (plain selection + `count`/`exists` only; no `filter`/`orderBy`/`limit`/`offset`/`first`)
 - `upvotes` → [cardUpvote](cardUpvote.md)

package/schema/models/workflowItem.md

@@ -41,5 +41,5 @@ Key: `itemId`
 ### hasMany
 
 - `diffs` → [workflowItemHistory](workflowItemHistory.md)
-- `inDeps` → [workflowItem](workflowItem.md)
-- `outDeps` → [workflowItem](workflowItem.md)
+- `inDeps` → [workflowItem](workflowItem.md) — `fkAsArray` (plain selection + `count`/`exists` only; no `filter`/`orderBy`/`limit`/`offset`/`first`)
+- `outDeps` → [workflowItem](workflowItem.md) — `fkAsArray` (plain selection + `count`/`exists` only; no `filter`/`orderBy`/`limit`/`offset`/`first`)

package/schema/query-syntax.md

@@ -150,6 +150,35 @@ Pass an array of queries with `as` aliases:
 
 ## Pagination (hasMany only)
 
+A subset (`limit`/`offset`) requires an `orderBy` — the API rejects a subset
+without an order. `offset` is only meaningful together with `limit`. The types
+enforce this, so `limit` on its own is a compile error.
+
+```ts
+{cards: {fields: ["title"], orderBy: "-createdAt", limit: 10, offset: 20}}
+```
+
+## `fkAsArray` relations (limited capabilities)
+
+A handful of hasMany relations are stored server-side as a plain id-array column
+rather than a joined table. These are flagged as `fkAsArray` on their model
+pages and currently are:
+
+- `card`: `childCards`, `inDeps`, `outDeps`, `cardReferences`, `attachments`
+- `workflowItem`: `inDeps`, `outDeps`
+
+They support **only** plain selection (`fields` + nested `relations`) and the
+`count`/`exists` aggregates. `filter`, `orderBy`, `limit`, `offset`, and
+`type: "first"` are not supported (the API rejects them), and the types reflect
+that.
+
 ```ts
-{cards: {fields: ["title"], limit: 10, offset: 20}}
+{childCards: {fields: ["cardId"]}}      // OK → array
+{childCards: {type: "count", as: "n"}}  // OK → number
+{childCards: {type: "exists", as: "hasChildren"}} // OK → boolean
+
+// compile errors:
+{childCards: {fields: ["cardId"], orderBy: "accountSeq"}}
+{childCards: {fields: ["cardId"], limit: 50, orderBy: "accountSeq"}}
+{childCards: {fields: ["cardId"], filter: {status: "started"}}}
 ```