@craftainer/crud-sdk 0.0.0-stage → 0.1.0

package/dist/tanstack/index.mjs

@@ -0,0 +1,226 @@
+import { i as tanstackCachePolicy, n as subscribeEvents, t as getEventHub } from "../events-Cqj9Rbon.mjs";
+//#region src/tanstack/adapter.ts
+/**
+* A query is the client's `ListOptions`, `StatsOptions` or `PredictOptions`
+* without `signal` (`{ filters, sort, skip, limit, ... }`); TanStack's signal
+* is added per call.
+*/
+function tanstackApi(client, resource) {
+	return {
+		list: (query, init) => resource.list({
+			...query,
+			...init
+		}),
+		get: (id, init) => resource.get(id, init),
+		stats: (query, init) => resource.stats({
+			...query,
+			...init
+		}),
+		predict: (query, init) => resource.predict({
+			...query,
+			...init
+		}),
+		revisions: (id, init) => resource.revisions(id, init),
+		manifest: () => client.manifest(),
+		create: (body) => resource.create(body),
+		update: (id, patch, init) => resource.update(id, patch, init),
+		delete: (id) => resource.delete(id)
+	};
+}
+//#endregion
+//#region src/tanstack/index.ts
+/** The key factory. Every key starts with `["crud", resource, ...]`, so prefixes invalidate by resource, kind or record. */
+const crudKeys = {
+	all: ["crud"],
+	resource: (resource) => ["crud", resource],
+	lists: (resource) => [
+		"crud",
+		resource,
+		"list"
+	],
+	list: (resource, query) => query === void 0 ? crudKeys.lists(resource) : [...crudKeys.lists(resource), query],
+	infiniteList: (resource, query, limit) => [
+		...crudKeys.lists(resource),
+		"infinite",
+		query,
+		limit
+	],
+	records: (resource) => [
+		"crud",
+		resource,
+		"record"
+	],
+	record: (resource, id) => [
+		"crud",
+		resource,
+		"record",
+		id
+	],
+	stats: (resource, query) => query === void 0 ? [
+		"crud",
+		resource,
+		"stats"
+	] : [
+		"crud",
+		resource,
+		"stats",
+		query
+	],
+	predict: (resource, query) => query === void 0 ? [
+		"crud",
+		resource,
+		"predict"
+	] : [
+		"crud",
+		resource,
+		"predict",
+		query
+	],
+	revisions: (resource, id) => [
+		"crud",
+		resource,
+		"revisions",
+		id
+	],
+	manifest: (scope) => scope === void 0 ? ["crud", "_manifest"] : [
+		"crud",
+		"_manifest",
+		scope
+	]
+};
+function tag(key) {
+	return key;
+}
+function listOptions(resource, api, query, init = {}) {
+	return {
+		queryKey: tag(crudKeys.list(resource, query)),
+		queryFn: ({ signal }) => api.list(query, { signal }),
+		staleTime: init.staleTime ?? 0
+	};
+}
+function recordOptions(resource, api, id, init = {}) {
+	return {
+		queryKey: tag(crudKeys.record(resource, id)),
+		queryFn: ({ signal }) => api.get(id, { signal }),
+		staleTime: init.staleTime ?? 0
+	};
+}
+function statsOptions(resource, api, query, init = {}) {
+	return {
+		queryKey: tag(crudKeys.stats(resource, query)),
+		queryFn: ({ signal }) => api.stats(query, { signal }),
+		staleTime: init.staleTime ?? 0
+	};
+}
+function predictOptions(resource, api, query, init = {}) {
+	return {
+		queryKey: tag(crudKeys.predict(resource, query)),
+		queryFn: ({ signal }) => api.predict(query, { signal }),
+		staleTime: init.staleTime ?? 0
+	};
+}
+function revisionsOptions(resource, api, id, init = {}) {
+	return {
+		queryKey: tag(crudKeys.revisions(resource, id)),
+		queryFn: ({ signal }) => api.revisions(id, { signal }),
+		staleTime: init.staleTime ?? 0
+	};
+}
+function manifestOptions(api, scope, init = {}) {
+	return {
+		queryKey: tag(crudKeys.manifest(scope)),
+		queryFn: ({ signal }) => api.manifest({ signal }),
+		staleTime: init.staleTime ?? 0
+	};
+}
+/** Offset paging: the next page starts at `skip + limit`, unless the last page was short. */
+function infiniteListOptions(resource, api, query = {}, init = {}) {
+	const limit = init.limit ?? 100;
+	const skipKey = init.skipKey ?? "skip";
+	const limitKey = init.limitKey ?? "limit";
+	return {
+		queryKey: tag(crudKeys.infiniteList(resource, query, limit)),
+		queryFn: ({ signal, pageParam }) => api.list({
+			...query,
+			[skipKey]: pageParam,
+			[limitKey]: limit
+		}, { signal }),
+		initialPageParam: 0,
+		getNextPageParam: (lastPage, _all, lastPageParam) => lastPage.length < limit ? void 0 : lastPageParam + limit,
+		staleTime: init.staleTime ?? 0
+	};
+}
+async function invalidateCollections(client, resource) {
+	await Promise.all([
+		client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),
+		client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),
+		client.invalidateQueries({ queryKey: crudKeys.predict(resource) })
+	]);
+}
+/** Create: invalidate lists, stats and predict. */
+function createMutationOptions(client, resource, api) {
+	return {
+		mutationKey: [
+			"crud",
+			resource,
+			"create"
+		],
+		mutationFn: (body) => api.create(body),
+		onSuccess: () => invalidateCollections(client, resource)
+	};
+}
+/** Update: `setQueryData` from the PATCH response, invalidate lists, stats, predict and revisions. */
+function updateMutationOptions(client, resource, api) {
+	return {
+		mutationKey: [
+			"crud",
+			resource,
+			"update"
+		],
+		mutationFn: ({ id, patch, ifMatch }) => api.update(id, patch, ifMatch === void 0 ? {} : { ifMatch }),
+		onSuccess: async (record, { id }) => {
+			client.setQueryData(crudKeys.record(resource, id), record);
+			await Promise.all([invalidateCollections(client, resource), client.invalidateQueries({ queryKey: crudKeys.revisions(resource, id) })]);
+		}
+	};
+}
+/** Delete: drop the record query, invalidate lists, stats, predict and revisions. */
+function deleteMutationOptions(client, resource, api) {
+	return {
+		mutationKey: [
+			"crud",
+			resource,
+			"delete"
+		],
+		mutationFn: (id) => api.delete(id),
+		onSuccess: async (_result, id) => {
+			client.removeQueries({ queryKey: crudKeys.record(resource, id) });
+			await Promise.all([invalidateCollections(client, resource), client.invalidateQueries({ queryKey: crudKeys.revisions(resource, id) })]);
+		}
+	};
+}
+/**
+* Invalidate TanStack queries from the resource's event stream. Events
+* invalidate and never apply snapshots: `create` invalidates lists, stats and
+* predict; `update`/`delete`/`restore` also the record and its revisions; a
+* reconnect (or an event with no usable record id) invalidates the resource.
+* Returns the unsubscribe.
+*/
+function bridgeEvents(client, hub, resource) {
+	return hub.subscribe({
+		onEvent: async (event) => {
+			const pending = [
+				client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),
+				client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),
+				client.invalidateQueries({ queryKey: crudKeys.predict(resource) })
+			];
+			if (event.action !== "create") pending.push(client.invalidateQueries({ queryKey: crudKeys.record(resource, event.recordId) }), client.invalidateQueries({ queryKey: crudKeys.revisions(resource, event.recordId) }));
+			await Promise.all(pending);
+		},
+		onReset: () => client.invalidateQueries({ queryKey: crudKeys.resource(resource) })
+	});
+}
+//#endregion
+export { bridgeEvents, createMutationOptions, crudKeys, deleteMutationOptions, getEventHub, infiniteListOptions, listOptions, manifestOptions, predictOptions, recordOptions, revisionsOptions, statsOptions, subscribeEvents, tanstackApi, tanstackCachePolicy, updateMutationOptions };
+
+//# sourceMappingURL=index.mjs.map

package/dist/tanstack/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/tanstack/adapter.ts","../../src/tanstack/index.ts"],"sourcesContent":["// Adapts TS1's `ResourceClient` (options-object methods) to the structural\n// slices the `./tanstack` factories take (`list(query, { signal })`, ...).\nimport type { CrudClient, ResourceClient } from \"../client.ts\";\nimport type { JsonObject, Manifest } from \"../manifest.ts\";\nimport type { CrudQuery } from \"./index.ts\";\n\ntype Init = { signal?: AbortSignal };\n\n/** What `tanstackApi` returns: every slice the factories use, bound to one resource. */\nexport interface TanstackApi<Read, Create, Update> {\n  list(query: CrudQuery | undefined, init?: Init): Promise<Read[]>;\n  get(id: number, init?: Init): Promise<Read>;\n  stats(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;\n  predict(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;\n  revisions(id: number, init?: Init): Promise<JsonObject[]>;\n  /** The manifest the client already loaded (the client's loader takes no signal). */\n  manifest(init?: Init): Promise<Manifest>;\n  create(body: Create): Promise<Read>;\n  update(id: number, patch: Update, init?: { ifMatch?: string }): Promise<Read>;\n  delete(id: number): Promise<void>;\n}\n\n/**\n * A query is the client's `ListOptions`, `StatsOptions` or `PredictOptions`\n * without `signal` (`{ filters, sort, skip, limit, ... }`); TanStack's signal\n * is added per call.\n */\nexport function tanstackApi<\n  Read extends object,\n  Create extends object,\n  Update extends object,\n>(\n  client: CrudClient,\n  resource: ResourceClient<Read, Create, Update>,\n): TanstackApi<Read, Create, Update> {\n  return {\n    list: (query, init) => resource.list({ ...query, ...init }),\n    get: (id, init) => resource.get(id, init),\n    stats: (query, init) => resource.stats({ ...query, ...init }),\n    predict: (query, init) => resource.predict({ ...query, ...init }),\n    revisions: (id, init) => resource.revisions(id, init),\n    manifest: () => client.manifest(),\n    create: (body) => resource.create(body),\n    update: (id, patch, init) => resource.update(id, patch, init),\n    delete: (id) => resource.delete(id),\n  };\n}\n","// Entry point `./tanstack`: `queryOptions` factories, key factory and the\n// invalidation bridge (TS2). Needs the optional peer `@tanstack/query-core`\n// (types only: nothing here imports it at runtime). query-core has no\n// `queryOptions`, so the factories return plain `{ queryKey, queryFn,\n// staleTime }` objects with `queryKey` tagged through `DataTag`; the React\n// wrappers live in lib-crud-views-ts.\nimport type { DataTag, InfiniteData, QueryClient } from \"@tanstack/query-core\";\nimport type { EventHub } from \"../events.ts\";\n\nexport { tanstackApi } from \"./adapter.ts\";\nexport type { TanstackApi } from \"./adapter.ts\";\nexport { tanstackCachePolicy } from \"../cache/policy.ts\";\nexport type { CachePolicy, ManifestCacheHints } from \"../cache/policy.ts\";\nexport { getEventHub, subscribeEvents } from \"../events.ts\";\nexport type {\n  EventHandlers,\n  EventHub,\n  EventHubOptions,\n  EventsConfig,\n  SubscribeEventsOptions,\n} from \"../events.ts\";\nexport type { CrudEvent } from \"../interfaces.ts\";\n\n/** A query object as the client's query builder takes it. */\nexport type CrudQuery = Readonly<Record<string, unknown>>;\n\ntype Key = readonly unknown[];\n\n/** The key factory type. */\nexport interface CrudKeys {\n  readonly all: readonly [\"crud\"];\n  /** Everything of one resource. */\n  resource(resource: string): readonly [\"crud\", string];\n  /** All lists of one resource, plain and infinite. */\n  lists(resource: string): readonly [\"crud\", string, \"list\"];\n  list(resource: string, query?: CrudQuery): Key;\n  infiniteList(resource: string, query: CrudQuery, limit: number): Key;\n  /** All record queries of one resource. */\n  records(resource: string): readonly [\"crud\", string, \"record\"];\n  record(\n    resource: string,\n    id: number,\n  ): readonly [\"crud\", string, \"record\", number];\n  stats(resource: string, query?: CrudQuery): Key;\n  predict(resource: string, query?: CrudQuery): Key;\n  revisions(\n    resource: string,\n    id: number,\n  ): readonly [\"crud\", string, \"revisions\", number];\n  /** The manifest, optionally of one caller scope. */\n  manifest(scope?: string): Key;\n}\n\n/** The key factory. Every key starts with `[\"crud\", resource, ...]`, so prefixes invalidate by resource, kind or record. */\nexport const crudKeys: CrudKeys = {\n  all: [\"crud\"],\n  resource: (resource) => [\"crud\", resource],\n  lists: (resource) => [\"crud\", resource, \"list\"],\n  list: (resource, query) =>\n    query === undefined\n      ? crudKeys.lists(resource)\n      : [...crudKeys.lists(resource), query],\n  infiniteList: (resource, query, limit) => [\n    ...crudKeys.lists(resource),\n    \"infinite\",\n    query,\n    limit,\n  ],\n  records: (resource) => [\"crud\", resource, \"record\"],\n  record: (resource, id) => [\"crud\", resource, \"record\", id],\n  stats: (resource, query) =>\n    query === undefined\n      ? [\"crud\", resource, \"stats\"]\n      : [\"crud\", resource, \"stats\", query],\n  predict: (resource, query) =>\n    query === undefined\n      ? [\"crud\", resource, \"predict\"]\n      : [\"crud\", resource, \"predict\", query],\n  revisions: (resource, id) => [\"crud\", resource, \"revisions\", id],\n  manifest: (scope) =>\n    scope === undefined ? [\"crud\", \"_manifest\"] : [\"crud\", \"_manifest\", scope],\n};\n\n/** What a query function receives from TanStack Query (a subset). */\nexport interface QueryContext {\n  readonly signal: AbortSignal;\n}\n\nexport interface QueryOptionsInit {\n  /** TanStack's `staleTime` in milliseconds. Default 0 (the SDK cache revalidates for free). */\n  readonly staleTime?: number;\n}\n\n/** Plain query options with a typed key; spread into `useQuery`/`fetchQuery`. */\nexport interface CrudQueryOptions<T> {\n  readonly queryKey: DataTag<Key, T, Error>;\n  readonly queryFn: (context: QueryContext) => Promise<T>;\n  readonly staleTime: number;\n}\n\nexport interface CrudInfiniteQueryOptions<T> {\n  readonly queryKey: DataTag<\n    Key,\n    { pages: T[][]; pageParams: number[] },\n    Error\n  >;\n  readonly queryFn: (\n    context: QueryContext & { pageParam: number },\n  ) => Promise<T[]>;\n  readonly initialPageParam: number;\n  /** `skip + limit` unless the page was short. */\n  readonly getNextPageParam: (\n    lastPage: T[],\n    allPages: T[][],\n    lastPageParam: number,\n  ) => number | undefined;\n  readonly staleTime: number;\n}\n\n/** The slices of a resource API the factories call (structural: TS1's resource client fits). */\nexport interface ListApi<T> {\n  list(\n    query: CrudQuery | undefined,\n    init?: { signal?: AbortSignal },\n  ): Promise<T[]>;\n}\nexport interface RecordApi<T> {\n  get(id: number, init?: { signal?: AbortSignal }): Promise<T>;\n}\nexport interface StatsApi<S> {\n  stats(\n    query: CrudQuery | undefined,\n    init?: { signal?: AbortSignal },\n  ): Promise<S>;\n}\nexport interface PredictApi<P> {\n  predict(\n    query: CrudQuery | undefined,\n    init?: { signal?: AbortSignal },\n  ): Promise<P>;\n}\nexport interface RevisionsApi<R> {\n  revisions(id: number, init?: { signal?: AbortSignal }): Promise<R[]>;\n}\nexport interface ManifestApi<M> {\n  manifest(init?: { signal?: AbortSignal }): Promise<M>;\n}\nexport interface CreateApi<T, C> {\n  create(body: C): Promise<T>;\n}\nexport interface UpdateApi<T, P> {\n  update(id: number, patch: P, init?: { ifMatch?: string }): Promise<T>;\n}\nexport interface DeleteApi {\n  delete(id: number): Promise<unknown>;\n}\n\nfunction tag<T>(key: Key): DataTag<Key, T, Error> {\n  return key as DataTag<Key, T, Error>;\n}\n\nexport function listOptions<T>(\n  resource: string,\n  api: ListApi<T>,\n  query?: CrudQuery,\n  init: QueryOptionsInit = {},\n): CrudQueryOptions<T[]> {\n  return {\n    queryKey: tag(crudKeys.list(resource, query)),\n    queryFn: ({ signal }) => api.list(query, { signal }),\n    staleTime: init.staleTime ?? 0,\n  };\n}\n\nexport function recordOptions<T>(\n  resource: string,\n  api: RecordApi<T>,\n  id: number,\n  init: QueryOptionsInit = {},\n): CrudQueryOptions<T> {\n  return {\n    queryKey: tag(crudKeys.record(resource, id)),\n    queryFn: ({ signal }) => api.get(id, { signal }),\n    staleTime: init.staleTime ?? 0,\n  };\n}\n\nexport function statsOptions<S>(\n  resource: string,\n  api: StatsApi<S>,\n  query?: CrudQuery,\n  init: QueryOptionsInit = {},\n): CrudQueryOptions<S> {\n  return {\n    queryKey: tag(crudKeys.stats(resource, query)),\n    queryFn: ({ signal }) => api.stats(query, { signal }),\n    staleTime: init.staleTime ?? 0,\n  };\n}\n\nexport function predictOptions<P>(\n  resource: string,\n  api: PredictApi<P>,\n  query?: CrudQuery,\n  init: QueryOptionsInit = {},\n): CrudQueryOptions<P> {\n  return {\n    queryKey: tag(crudKeys.predict(resource, query)),\n    queryFn: ({ signal }) => api.predict(query, { signal }),\n    staleTime: init.staleTime ?? 0,\n  };\n}\n\nexport function revisionsOptions<R>(\n  resource: string,\n  api: RevisionsApi<R>,\n  id: number,\n  init: QueryOptionsInit = {},\n): CrudQueryOptions<R[]> {\n  return {\n    queryKey: tag(crudKeys.revisions(resource, id)),\n    queryFn: ({ signal }) => api.revisions(id, { signal }),\n    staleTime: init.staleTime ?? 0,\n  };\n}\n\nexport function manifestOptions<M>(\n  api: ManifestApi<M>,\n  scope?: string,\n  init: QueryOptionsInit = {},\n): CrudQueryOptions<M> {\n  return {\n    queryKey: tag(crudKeys.manifest(scope)),\n    queryFn: ({ signal }) => api.manifest({ signal }),\n    staleTime: init.staleTime ?? 0,\n  };\n}\n\nexport interface InfiniteListInit extends QueryOptionsInit {\n  /** Page size; default 100 (the server's default). */\n  readonly limit?: number;\n  /**\n   * Keys of the paging parameters in the query object handed to `api.list`.\n   * Default `skip`/`limit`, which is what `tanstackApi` (the client's\n   * `ListOptions`) reads; change them only for a hand-written `ListApi`. The\n   * client maps them to the manifest's `skip_param`/`limit_param` itself.\n   */\n  readonly skipKey?: string;\n  readonly limitKey?: string;\n}\n\n/** Offset paging: the next page starts at `skip + limit`, unless the last page was short. */\nexport function infiniteListOptions<T>(\n  resource: string,\n  api: ListApi<T>,\n  query: CrudQuery = {},\n  init: InfiniteListInit = {},\n): CrudInfiniteQueryOptions<T> {\n  const limit = init.limit ?? 100;\n  const skipKey = init.skipKey ?? \"skip\";\n  const limitKey = init.limitKey ?? \"limit\";\n  return {\n    queryKey: tag<InfiniteData<T[], number>>(\n      crudKeys.infiniteList(resource, query, limit),\n    ),\n    queryFn: ({ signal, pageParam }) =>\n      api.list(\n        { ...query, [skipKey]: pageParam, [limitKey]: limit },\n        { signal },\n      ),\n    initialPageParam: 0,\n    getNextPageParam: (lastPage, _all, lastPageParam) =>\n      lastPage.length < limit ? undefined : lastPageParam + limit,\n    staleTime: init.staleTime ?? 0,\n  };\n}\n\nexport type Invalidator = Pick<\n  QueryClient,\n  \"invalidateQueries\" | \"removeQueries\" | \"setQueryData\"\n>;\n\nasync function invalidateCollections(\n  client: Invalidator,\n  resource: string,\n): Promise<void> {\n  await Promise.all([\n    client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),\n    client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),\n    client.invalidateQueries({ queryKey: crudKeys.predict(resource) }),\n  ]);\n}\n\nexport interface CreateMutationOptions<T, C> {\n  readonly mutationKey: readonly [\"crud\", string, \"create\"];\n  readonly mutationFn: (body: C) => Promise<T>;\n  readonly onSuccess: () => Promise<void>;\n}\n\nexport interface UpdateMutationOptions<T, P> {\n  readonly mutationKey: readonly [\"crud\", string, \"update\"];\n  readonly mutationFn: (variables: UpdateVariables<P>) => Promise<T>;\n  readonly onSuccess: (\n    record: T,\n    variables: UpdateVariables<P>,\n  ) => Promise<void>;\n}\n\nexport interface DeleteMutationOptions {\n  readonly mutationKey: readonly [\"crud\", string, \"delete\"];\n  readonly mutationFn: (id: number) => Promise<unknown>;\n  readonly onSuccess: (result: unknown, id: number) => Promise<void>;\n}\n\n/** Create: invalidate lists, stats and predict. */\nexport function createMutationOptions<T, C>(\n  client: Invalidator,\n  resource: string,\n  api: CreateApi<T, C>,\n): CreateMutationOptions<T, C> {\n  return {\n    mutationKey: [\"crud\", resource, \"create\"],\n    mutationFn: (body: C) => api.create(body),\n    onSuccess: () => invalidateCollections(client, resource),\n  };\n}\n\nexport interface UpdateVariables<P> {\n  readonly id: number;\n  readonly patch: P;\n  /** Sent as `If-Match`; a stale one fails with 412. */\n  readonly ifMatch?: string;\n}\n\n/** Update: `setQueryData` from the PATCH response, invalidate lists, stats, predict and revisions. */\nexport function updateMutationOptions<T, P>(\n  client: Invalidator,\n  resource: string,\n  api: UpdateApi<T, P>,\n): UpdateMutationOptions<T, P> {\n  return {\n    mutationKey: [\"crud\", resource, \"update\"],\n    mutationFn: ({ id, patch, ifMatch }: UpdateVariables<P>) =>\n      api.update(id, patch, ifMatch === undefined ? {} : { ifMatch }),\n    onSuccess: async (record: T, { id }: UpdateVariables<P>) => {\n      client.setQueryData(crudKeys.record(resource, id), record);\n      await Promise.all([\n        invalidateCollections(client, resource),\n        client.invalidateQueries({\n          queryKey: crudKeys.revisions(resource, id),\n        }),\n      ]);\n    },\n  };\n}\n\n/** Delete: drop the record query, invalidate lists, stats, predict and revisions. */\nexport function deleteMutationOptions(\n  client: Invalidator,\n  resource: string,\n  api: DeleteApi,\n): DeleteMutationOptions {\n  return {\n    mutationKey: [\"crud\", resource, \"delete\"],\n    mutationFn: (id: number) => api.delete(id),\n    onSuccess: async (_result: unknown, id: number) => {\n      client.removeQueries({ queryKey: crudKeys.record(resource, id) });\n      await Promise.all([\n        invalidateCollections(client, resource),\n        client.invalidateQueries({\n          queryKey: crudKeys.revisions(resource, id),\n        }),\n      ]);\n    },\n  };\n}\n\n/**\n * Invalidate TanStack queries from the resource's event stream. Events\n * invalidate and never apply snapshots: `create` invalidates lists, stats and\n * predict; `update`/`delete`/`restore` also the record and its revisions; a\n * reconnect (or an event with no usable record id) invalidates the resource.\n * Returns the unsubscribe.\n */\nexport function bridgeEvents(\n  client: Pick<QueryClient, \"invalidateQueries\">,\n  hub: EventHub,\n  resource: string,\n): () => void {\n  return hub.subscribe({\n    onEvent: async (event) => {\n      const pending = [\n        client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),\n        client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),\n        client.invalidateQueries({ queryKey: crudKeys.predict(resource) }),\n      ];\n      if (event.action !== \"create\") {\n        pending.push(\n          client.invalidateQueries({\n            queryKey: crudKeys.record(resource, event.recordId),\n          }),\n          client.invalidateQueries({\n            queryKey: crudKeys.revisions(resource, event.recordId),\n          }),\n        );\n      }\n      await Promise.all(pending);\n    },\n    onReset: () =>\n      client.invalidateQueries({ queryKey: crudKeys.resource(resource) }),\n  });\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,82 @@
 {
   "name": "@craftainer/crud-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Typed fetch client for craftainer CRUD APIs: manifest-driven resources, query builder, problem-details errors, opt-in cache with SSE invalidation and TanStack Query helpers.",
+  "license": "GPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/craftainer/lib-crud-sdk-ts.git"
+  },
+  "homepage": "https://github.com/craftainer/lib-crud-sdk-ts#readme",
+  "bugs": {
+    "url": "https://github.com/craftainer/lib-crud-sdk-ts/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "packageManager": "pnpm@12.14.0",
+  "engines": {
+    "node": ">=24.22.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "crud-sdk-codegen": "./dist/codegen/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.mts",
+      "default": "./dist/cache/index.mjs"
+    },
+    "./tanstack": {
+      "types": "./dist/tanstack/index.d.mts",
+      "default": "./dist/tanstack/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint",
+    "format": "prettier --check .",
+    "format:write": "prettier --write .",
+    "test": "vitest run --coverage",
+    "publint": "publint --strict",
+    "attw": "attw --pack . --profile esm-only",
+    "lockfile": "pnpm install --frozen-lockfile --lockfile-only"
+  },
+  "peerDependencies": {
+    "@tanstack/query-core": "^5.90.0",
+    "json-schema-to-typescript": "^16.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/query-core": {
+      "optional": true
+    },
+    "json-schema-to-typescript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
+    "@tanstack/query-core": "5.104.5",
+    "@types/node": "24.19.2",
+    "@vitest/coverage-v8": "5.0.5",
+    "eventsource-parser": "4.1.2",
+    "fake-indexeddb": "6.2.6",
+    "idb": "8.0.4",
+    "json-schema-to-typescript": "16.0.0",
+    "oxlint": "1.89.0",
+    "prettier": "3.9.10",
+    "publint": "0.3.25",
+    "tsdown": "0.23.1",
+    "typescript": "6.0.3",
+    "vitest": "5.0.5"
+  }
+}