@anchrd/intel-contract 0.4.0 → 0.4.2

package/dist/contract/contract.d.ts

@@ -73,6 +73,7 @@ export type KnowledgeVersion = z.infer<typeof KnowledgeVersion>;
 export declare const ListKnowledgeNodesInput: z.ZodObject<{
     parentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     includeArchived: z.ZodDefault<z.ZodBoolean>;
+    archivedOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type ListKnowledgeNodesInput = z.infer<typeof ListKnowledgeNodesInput>;
 export declare const GetKnowledgeNodeInput: z.ZodObject<{
@@ -1320,8 +1321,17 @@ export declare const UpdateFlowInput: z.ZodObject<{
     idempotencyKey: z.ZodString;
 }, z.core.$strict>;
 export type UpdateFlowInput = z.infer<typeof UpdateFlowInput>;
+export declare const ArchiveFlowInput: z.ZodObject<{
+    flowId: z.ZodString;
+    baseUpdatedAt: z.ZodISODateTime;
+    archived: z.ZodBoolean;
+    idempotencyKey: z.ZodString;
+}, z.core.$strict>;
+export type ArchiveFlowInput = z.infer<typeof ArchiveFlowInput>;
 export declare const ListFlowsInput: z.ZodObject<{
     parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    includeArchived: z.ZodOptional<z.ZodBoolean>;
+    archivedOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type ListFlowsInput = z.infer<typeof ListFlowsInput>;
 export declare const GetFlowInput: z.ZodObject<{

package/dist/contract/contract.js

@@ -60,6 +60,14 @@ export const KnowledgeVersion = z.strictObject({
 export const ListKnowledgeNodesInput = z.strictObject({
     parentId: IntelId.nullable().default(null),
     includeArchived: z.boolean().default(false),
+    // ⚠️ Overrides `parentId` rather than narrowing beside it: what is archived is asked for across
+    // the whole tree, because that is the only useful question. Somebody looking for what they threw
+    // away does not know which folder it was in — if they did, they would not be looking (#113).
+    // A separate flag rather than a third state on `includeArchived`, so no existing caller changes
+    // meaning — and `.optional()` rather than `.default(false)` for the same reason `ListFlowsInput`
+    // carries it that way: a default makes the field required in the PARSED type, and every existing
+    // caller would have to answer a question it is not asking.
+    archivedOnly: z.boolean().optional(),
 });
 export const GetKnowledgeNodeInput = z.strictObject({ nodeId: IntelId });
 export const ListKnowledgeGrantsInput = z.strictObject({ resourceId: IntelId });
@@ -604,11 +612,31 @@ export const UpdateFlowInput = z
     idempotencyKey: z.string().min(8).max(200),
 })
     .refine((input) => input.title !== undefined || input.description !== undefined || input.parentId !== undefined, { error: "At least one change is required" });
+// Archiving a flow is the same shape as archiving a document, deliberately: `archived` is a boolean
+// rather than a one-way verb, because an archive nothing returns from is a delete under a friendlier
+// name. Restoring is the same call with `false`.
+export const ArchiveFlowInput = z.strictObject({
+    flowId: IntelId,
+    baseUpdatedAt: IsoDateTime,
+    archived: z.boolean(),
+    idempotencyKey: z.string().min(8).max(200),
+});
 // Three answers, not two: an absent `parentId` lists every visible flow (the search dialog asks
 // that), `null` lists the root of the shared tree and an ID lists one folder (the sidebar tree asks
 // per level, which is what keeps the tree off the N+1 it used to load with).
 export const ListFlowsInput = z.strictObject({
     parentId: IntelId.nullable().optional(),
+    // The only way back to an archived flow, and the only place that asks for one: the bounded read
+    // behind the relation graph has no such flag on purpose (#30). A drawing that includes what was
+    // archived says the tidying up never happened.
+    //
+    // ⚠️ `.optional()` rather than `.default(false)`, unlike `ListKnowledgeNodesInput`. This schema is
+    // the argument type of `listFlows` on three layers, and a default makes the field required in the
+    // *parsed* type — every existing caller that lists a folder would have to spell out the answer to
+    // a question it is not asking. Absent means "without the archive" everywhere it is read.
+    includeArchived: z.boolean().optional(),
+    // The same question for flows, and the same override of `parentId` — see `ListKnowledgeNodesInput`.
+    archivedOnly: z.boolean().optional(),
 });
 export const GetFlowInput = z.strictObject({ flowId: IntelId });
 export const SaveFlowVersionInput = z.strictObject({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anchrd/intel-contract",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {