@cat-factory/contracts 0.34.0 → 0.35.0

package/dist/routes/fragment-library.js

@@ -0,0 +1,102 @@
+import { ContractNoBody, defineApiContract, withObjectKeys } from '@toad-contracts/valibot';
+import * as v from 'valibot';
+import { promptFragmentSchema } from '../entities.js';
+import { createDocumentFragmentSchema, createPromptFragmentSchema, fragmentSourceSchema, fragmentSourceStatusSchema, fragmentSyncResultSchema, linkFragmentSourceSchema, resolvedFragmentCatalogSchema, updatePromptFragmentSchema, } from '../fragment-library.js';
+import { errorResponses } from './_shared.js';
+// ---------------------------------------------------------------------------
+// Prompt-fragment library route contracts. See FragmentLibraryController in
+// @cat-factory/server. The controller is mounted at BOTH `/accounts/:accountId`
+// and `/workspaces/:workspaceId` from a single factory, so its route literals are
+// RELATIVE to whichever prefix it is mounted under — the owner id (accountId /
+// workspaceId) is read by the handler via its own param helper and is NOT a
+// contract param. One set of relative contracts serves both mounts.
+//
+// Fragment ids are dot-separated (e.g. `node.performance`), never slash-bearing, so a
+// plain `:fragmentId` (Hono's default `[^/]+`) matches them and the shared resolver works
+// for both the server route and the client URL (a `{.+}` matcher would leak into the
+// client-built URL).
+// ---------------------------------------------------------------------------
+const promptFragmentListSchema = v.array(promptFragmentSchema);
+const fragmentSourceListSchema = v.array(fragmentSourceSchema);
+const fragmentIdParams = withObjectKeys(v.object({ fragmentId: v.string() }));
+const sourceIdParams = withObjectKeys(v.object({ id: v.string() }));
+// ---- fragments (this tier, raw — not merged) ------------------------------
+export const listPromptFragmentsContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/prompt-fragments',
+    responsesByStatusCode: { 200: promptFragmentListSchema, ...errorResponses },
+});
+export const createPromptFragmentContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/prompt-fragments',
+    requestBodySchema: createPromptFragmentSchema,
+    responsesByStatusCode: { 201: promptFragmentSchema, ...errorResponses },
+});
+export const updatePromptFragmentContract = defineApiContract({
+    method: 'patch',
+    requestPathParamsSchema: fragmentIdParams,
+    pathResolver: ({ fragmentId }) => `/prompt-fragments/${fragmentId}`,
+    requestBodySchema: updatePromptFragmentSchema,
+    responsesByStatusCode: { 200: promptFragmentSchema, ...errorResponses },
+});
+export const deletePromptFragmentContract = defineApiContract({
+    method: 'delete',
+    requestPathParamsSchema: fragmentIdParams,
+    pathResolver: ({ fragmentId }) => `/prompt-fragments/${fragmentId}`,
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+// ---- document-backed fragments (living source of truth) -------------------
+export const createDocumentFragmentContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/document-fragments',
+    requestBodySchema: createDocumentFragmentSchema,
+    responsesByStatusCode: { 201: promptFragmentSchema, ...errorResponses },
+});
+export const refreshPromptFragmentContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: fragmentIdParams,
+    // At the account scope the refresh needs a `viaWorkspaceId` (whose document-source
+    // connection to fetch through); ignored at the workspace scope.
+    requestQuerySchema: v.object({ viaWorkspaceId: v.optional(v.string()) }),
+    pathResolver: ({ fragmentId }) => `/prompt-fragments/${fragmentId}/refresh`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: promptFragmentSchema, ...errorResponses },
+});
+// ---- repo sources ---------------------------------------------------------
+export const listFragmentSourcesContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/fragment-sources',
+    responsesByStatusCode: { 200: fragmentSourceListSchema, ...errorResponses },
+});
+export const linkFragmentSourceContract = defineApiContract({
+    method: 'post',
+    pathResolver: () => '/fragment-sources',
+    requestBodySchema: linkFragmentSourceSchema,
+    responsesByStatusCode: { 201: fragmentSourceSchema, ...errorResponses },
+});
+export const unlinkFragmentSourceContract = defineApiContract({
+    method: 'delete',
+    requestPathParamsSchema: sourceIdParams,
+    pathResolver: ({ id }) => `/fragment-sources/${id}`,
+    responsesByStatusCode: { 204: ContractNoBody, ...errorResponses },
+});
+export const fragmentSourceStatusContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: sourceIdParams,
+    pathResolver: ({ id }) => `/fragment-sources/${id}/status`,
+    responsesByStatusCode: { 200: fragmentSourceStatusSchema, ...errorResponses },
+});
+export const syncFragmentSourceContract = defineApiContract({
+    method: 'post',
+    requestPathParamsSchema: sourceIdParams,
+    pathResolver: ({ id }) => `/fragment-sources/${id}/sync`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: fragmentSyncResultSchema, ...errorResponses },
+});
+// ---- resolved (workspace only) — the merged catalog an agent sees ---------
+export const resolvedFragmentsContract = defineApiContract({
+    method: 'get',
+    pathResolver: () => '/prompt-fragments/resolved',
+    responsesByStatusCode: { 200: resolvedFragmentCatalogSchema, ...errorResponses },
+});
+//# sourceMappingURL=fragment-library.js.map

package/dist/routes/fragment-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-library.js","sourceRoot":"","sources":["../../src/routes/fragment-library.ts"],"names":[],"mappings":"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"}