@interactive-inc/docs-client 0.0.9 → 0.0.11

package/build/models.js

@@ -1,81 +1,74 @@
 // lib/models.ts
-import { z } from "zod/v4";
+import { z } from "zod";
 var zDocFilePath = z.object({
   name: z.string(),
   path: z.string(),
   fullPath: z.string(),
   nameWithExtension: z.string()
 });
-var zDocSchemaFieldTypeText = z.literal("text");
-var zDocSchemaFieldTypeNumber = z.literal("number");
-var zDocSchemaFieldTypeBoolean = z.literal("boolean");
-var zDocSchemaFieldTypeMultiText = z.literal("multi-text");
-var zDocSchemaFieldTypeMultiNumber = z.literal("multi-number");
-var zDocSchemaFieldTypeMultiBoolean = z.literal("multi-boolean");
-var zDocSchemaFieldTypeRelation = z.literal("relation");
-var zDocSchemaFieldTypeMultiRelation = z.literal("multi-relation");
-var zDocSchemaFieldTypeSelectText = z.literal("select-text");
-var zDocSchemaFieldTypeSelectNumber = z.literal("select-number");
-var zDocSchemaFieldTypeMultiSelectText = z.literal("multi-select-text");
-var zDocSchemaFieldTypeMultiSelectNumber = z.literal("multi-select-number");
-var zDocSchemaFieldType = z.union([
-  zDocSchemaFieldTypeText,
-  zDocSchemaFieldTypeNumber,
-  zDocSchemaFieldTypeBoolean,
-  zDocSchemaFieldTypeMultiText,
-  zDocSchemaFieldTypeMultiNumber,
-  zDocSchemaFieldTypeMultiBoolean,
-  zDocSchemaFieldTypeRelation,
-  zDocSchemaFieldTypeMultiRelation,
-  zDocSchemaFieldTypeSelectText,
-  zDocSchemaFieldTypeSelectNumber,
-  zDocSchemaFieldTypeMultiSelectText,
-  zDocSchemaFieldTypeMultiSelectNumber
+var zDocMetaFieldTypeText = z.literal("text");
+var zDocMetaFieldTypeNumber = z.literal("number");
+var zDocMetaFieldTypeBoolean = z.literal("boolean");
+var zDocMetaFieldTypeSelectText = z.literal("select-text");
+var zDocMetaFieldTypeSelectNumber = z.literal("select-number");
+var zDocMetaFieldTypeRelation = z.literal("relation");
+var zDocMetaFieldTypeMultiText = z.literal("multi-text");
+var zDocMetaFieldTypeMultiNumber = z.literal("multi-number");
+var zDocMetaFieldTypeMultiRelation = z.literal("multi-relation");
+var zDocMetaFieldTypeMultiSelectText = z.literal("multi-select-text");
+var zDocMetaFieldTypeMultiSelectNumber = z.literal(
+  "multi-select-number"
+);
+var zDocMetaFieldType = z.union([
+  zDocMetaFieldTypeText,
+  zDocMetaFieldTypeNumber,
+  zDocMetaFieldTypeBoolean,
+  zDocMetaFieldTypeMultiText,
+  zDocMetaFieldTypeMultiNumber,
+  zDocMetaFieldTypeRelation,
+  zDocMetaFieldTypeMultiRelation,
+  zDocMetaFieldTypeSelectText,
+  zDocMetaFieldTypeSelectNumber,
+  zDocMetaFieldTypeMultiSelectText,
+  zDocMetaFieldTypeMultiSelectNumber
 ]);
 var zDocSchemaFieldText = z.object({
-  type: zDocSchemaFieldTypeText,
+  type: zDocMetaFieldTypeText,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
   default: z.string().nullable()
 });
 var zDocSchemaFieldNumber = z.object({
-  type: zDocSchemaFieldTypeNumber,
+  type: zDocMetaFieldTypeNumber,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
   default: z.number().nullable()
 });
 var zDocSchemaFieldBoolean = z.object({
-  type: zDocSchemaFieldTypeBoolean,
+  type: zDocMetaFieldTypeBoolean,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
   default: z.boolean().nullable()
 });
 var zDocSchemaFieldMultiText = z.object({
-  type: zDocSchemaFieldTypeMultiText,
+  type: zDocMetaFieldTypeMultiText,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
   default: z.array(z.string()).nullable()
 });
 var zDocSchemaFieldMultiNumber = z.object({
-  type: zDocSchemaFieldTypeMultiNumber,
+  type: zDocMetaFieldTypeMultiNumber,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
   default: z.array(z.number()).nullable()
 });
-var zDocSchemaFieldMultiBoolean = z.object({
-  type: zDocSchemaFieldTypeMultiBoolean,
-  required: z.boolean(),
-  title: z.string().nullable(),
-  description: z.string().nullable(),
-  default: z.array(z.boolean()).nullable()
-});
 var zDocSchemaFieldRelation = z.object({
-  type: zDocSchemaFieldTypeRelation,
+  type: zDocMetaFieldTypeRelation,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
@@ -83,7 +76,7 @@ var zDocSchemaFieldRelation = z.object({
   default: z.string().nullable()
 });
 var zDocSchemaFieldMultiRelation = z.object({
-  type: zDocSchemaFieldTypeMultiRelation,
+  type: zDocMetaFieldTypeMultiRelation,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
@@ -91,7 +84,7 @@ var zDocSchemaFieldMultiRelation = z.object({
   default: z.array(z.string()).nullable()
 });
 var zDocSchemaFieldSelectText = z.object({
-  type: zDocSchemaFieldTypeSelectText,
+  type: zDocMetaFieldTypeSelectText,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
@@ -99,7 +92,7 @@ var zDocSchemaFieldSelectText = z.object({
   default: z.string().nullable()
 });
 var zDocSchemaFieldSelectNumber = z.object({
-  type: zDocSchemaFieldTypeSelectNumber,
+  type: zDocMetaFieldTypeSelectNumber,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
@@ -107,7 +100,7 @@ var zDocSchemaFieldSelectNumber = z.object({
   default: z.number().nullable()
 });
 var zDocSchemaFieldMultiSelectText = z.object({
-  type: zDocSchemaFieldTypeMultiSelectText,
+  type: zDocMetaFieldTypeMultiSelectText,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
@@ -115,20 +108,19 @@ var zDocSchemaFieldMultiSelectText = z.object({
   default: z.array(z.string()).nullable()
 });
 var zDocSchemaFieldMultiSelectNumber = z.object({
-  type: zDocSchemaFieldTypeMultiSelectNumber,
+  type: zDocMetaFieldTypeMultiSelectNumber,
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
   options: z.array(z.number()),
   default: z.array(z.number()).nullable()
 });
-var zDocSchemaField = z.union([
+var zDocFileIndexSchemaField = z.union([
   zDocSchemaFieldText,
   zDocSchemaFieldNumber,
   zDocSchemaFieldBoolean,
   zDocSchemaFieldMultiText,
   zDocSchemaFieldMultiNumber,
-  zDocSchemaFieldMultiBoolean,
   zDocSchemaFieldRelation,
   zDocSchemaFieldMultiRelation,
   zDocSchemaFieldSelectText,
@@ -136,24 +128,99 @@ var zDocSchemaField = z.union([
   zDocSchemaFieldMultiSelectText,
   zDocSchemaFieldMultiSelectNumber
 ]);
-var zDocFileMdFrontMatter = z.record(
+var zDocMetaFieldText = z.string().nullable();
+var zDocMetaFieldBoolean = z.boolean().nullable();
+var zDocMetaFieldNumber = z.number().nullable();
+var zDocMetaFieldSelectText = z.string().nullable();
+var zDocMetaFieldSelectNumber = z.number().nullable();
+var zDocMetaFieldRelation = z.string().nullable();
+var zDocMetaFieldMultiText = z.string().array();
+var zDocMetaFieldMultiNumber = z.number().array();
+var zDocMetaFieldMultiBoolean = z.boolean().array();
+var zDocMetaFieldMultiSelectText = z.string().array();
+var zDocMetaFieldMultiSelectNumber = z.number().array();
+var zDocMetaFieldMultiRelation = z.string().array();
+var zDocMetaField = z.union([
+  zDocMetaFieldText,
+  zDocMetaFieldBoolean,
+  zDocMetaFieldNumber,
+  zDocMetaFieldSelectText,
+  zDocMetaFieldSelectNumber,
+  zDocMetaFieldRelation,
+  zDocMetaFieldMultiText,
+  zDocMetaFieldMultiNumber,
+  zDocMetaFieldMultiBoolean,
+  zDocMetaFieldMultiSelectText,
+  zDocMetaFieldMultiSelectNumber,
+  zDocMetaFieldMultiRelation
+]);
+var zDocFileMdMeta = z.record(z.string(), zDocMetaField);
+var zDocFileIndexSchema = z.record(
   z.string(),
-  z.union([
-    z.string(),
-    z.boolean(),
-    z.number(),
-    z.array(z.string()),
-    z.array(z.number()),
-    z.array(z.boolean()),
-    z.record(z.string(), z.unknown()),
-    z.null()
-  ])
+  zDocFileIndexSchemaField
 );
-var zDocSchema = z.record(z.string(), zDocSchemaField);
-var zDocFileIndexFrontMatter = z.object({
-  type: z.literal("index-frontmatter"),
-  icon: z.string(),
-  schema: zDocSchema
+var zDocCustomSchemaFieldText = z.object({
+  type: zDocMetaFieldTypeText,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldNumber = z.object({
+  type: zDocMetaFieldTypeNumber,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldBoolean = z.object({
+  type: zDocMetaFieldTypeBoolean,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldRelation = z.object({
+  type: zDocMetaFieldTypeRelation,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldSelectText = z.object({
+  type: zDocMetaFieldTypeSelectText,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldSelectNumber = z.object({
+  type: zDocMetaFieldTypeSelectNumber,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldMultiText = z.object({
+  type: zDocMetaFieldTypeMultiText,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldMultiNumber = z.object({
+  type: zDocMetaFieldTypeMultiNumber,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldMultiRelation = z.object({
+  type: zDocMetaFieldTypeMultiRelation,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldMultiSelectText = z.object({
+  type: zDocMetaFieldTypeMultiSelectText,
+  required: z.boolean()
+});
+var zDocCustomSchemaFieldMultiSelectNumber = z.object({
+  type: zDocMetaFieldTypeMultiSelectNumber,
+  required: z.boolean()
+});
+var zDocCustomSchemaField = z.union([
+  zDocCustomSchemaFieldText,
+  zDocCustomSchemaFieldNumber,
+  zDocCustomSchemaFieldBoolean,
+  zDocCustomSchemaFieldRelation,
+  zDocCustomSchemaFieldSelectText,
+  zDocCustomSchemaFieldSelectNumber,
+  zDocCustomSchemaFieldMultiText,
+  zDocCustomSchemaFieldMultiNumber,
+  zDocCustomSchemaFieldMultiRelation,
+  zDocCustomSchemaFieldMultiSelectText,
+  zDocCustomSchemaFieldMultiSelectNumber
+]);
+var zDocCustomSchema = z.record(z.string(), zDocCustomSchemaField);
+var zDocFileIndexMeta = z.object({
+  type: z.literal("index-meta"),
+  icon: z.string().nullable(),
+  schema: zDocFileIndexSchema
 });
 var zDocRelationField = z.object({
   fieldName: z.string(),
@@ -170,24 +237,24 @@ var zDocRelation = z.object({
   path: z.string(),
   files: z.array(zDocRelationFile)
 });
-var zDocFileContentMd = z.object({
+var zDocFileMdContent = z.object({
   type: z.literal("markdown-content"),
   body: z.string(),
   title: z.string(),
   description: z.string(),
-  frontMatter: zDocFileMdFrontMatter
+  meta: zDocFileMdMeta
 });
-var zDocFileContentIndex = z.object({
+var zDocFileIndexContent = z.object({
   type: z.literal("markdown-index"),
   body: z.string(),
   title: z.string(),
   description: z.string(),
-  frontMatter: zDocFileIndexFrontMatter
+  meta: zDocFileIndexMeta
 });
 var zDocFileIndex = z.object({
   type: z.literal("index"),
   path: zDocFilePath,
-  content: zDocFileContentIndex,
+  content: zDocFileIndexContent,
   isArchived: z.boolean()
 });
 var zDocFileUnknown = z.object({
@@ -200,7 +267,7 @@ var zDocFileUnknown = z.object({
 var zDocFileMd = z.object({
   type: z.literal("markdown"),
   path: zDocFilePath,
-  content: zDocFileContentMd,
+  content: zDocFileMdContent,
   isArchived: z.boolean()
 });
 var zDocFile = z.union([zDocFileIndex, zDocFileMd, zDocFileUnknown]);
@@ -222,23 +289,76 @@ var zDocTreeDirectoryNode = z.lazy(() => {
   });
 });
 var zDocTreeNode = z.union([zDocTreeFileNode, zDocTreeDirectoryNode]);
+var zDocClientConfig = z.object({
+  defaultIndexIcon: z.string().optional(),
+  indexFileName: z.string().optional(),
+  archiveDirectoryName: z.string().optional(),
+  defaultDirectoryName: z.string().optional(),
+  indexMetaIncludes: z.array(z.string()).optional(),
+  directoryExcludes: z.array(z.string()).optional()
+}).transform((data) => ({
+  defaultIndexIcon: data.defaultIndexIcon ?? "\u{1F4C3}",
+  indexFileName: data.indexFileName ?? "index.md",
+  archiveDirectoryName: data.archiveDirectoryName ?? "_",
+  defaultDirectoryName: data.defaultDirectoryName ?? "Directory",
+  indexMetaIncludes: data.indexMetaIncludes ?? [],
+  directoryExcludes: data.directoryExcludes ?? [".vitepress"]
+}));
 export {
+  zDocClientConfig,
+  zDocCustomSchema,
+  zDocCustomSchemaField,
+  zDocCustomSchemaFieldBoolean,
+  zDocCustomSchemaFieldMultiNumber,
+  zDocCustomSchemaFieldMultiRelation,
+  zDocCustomSchemaFieldMultiSelectNumber,
+  zDocCustomSchemaFieldMultiSelectText,
+  zDocCustomSchemaFieldMultiText,
+  zDocCustomSchemaFieldNumber,
+  zDocCustomSchemaFieldRelation,
+  zDocCustomSchemaFieldSelectNumber,
+  zDocCustomSchemaFieldSelectText,
+  zDocCustomSchemaFieldText,
   zDocFile,
-  zDocFileContentIndex,
-  zDocFileContentMd,
   zDocFileIndex,
-  zDocFileIndexFrontMatter,
+  zDocFileIndexContent,
+  zDocFileIndexMeta,
+  zDocFileIndexSchema,
+  zDocFileIndexSchemaField,
   zDocFileMd,
-  zDocFileMdFrontMatter,
+  zDocFileMdContent,
+  zDocFileMdMeta,
   zDocFilePath,
   zDocFileUnknown,
+  zDocMetaField,
+  zDocMetaFieldBoolean,
+  zDocMetaFieldMultiBoolean,
+  zDocMetaFieldMultiNumber,
+  zDocMetaFieldMultiRelation,
+  zDocMetaFieldMultiSelectNumber,
+  zDocMetaFieldMultiSelectText,
+  zDocMetaFieldMultiText,
+  zDocMetaFieldNumber,
+  zDocMetaFieldRelation,
+  zDocMetaFieldSelectNumber,
+  zDocMetaFieldSelectText,
+  zDocMetaFieldText,
+  zDocMetaFieldType,
+  zDocMetaFieldTypeBoolean,
+  zDocMetaFieldTypeMultiNumber,
+  zDocMetaFieldTypeMultiRelation,
+  zDocMetaFieldTypeMultiSelectNumber,
+  zDocMetaFieldTypeMultiSelectText,
+  zDocMetaFieldTypeMultiText,
+  zDocMetaFieldTypeNumber,
+  zDocMetaFieldTypeRelation,
+  zDocMetaFieldTypeSelectNumber,
+  zDocMetaFieldTypeSelectText,
+  zDocMetaFieldTypeText,
   zDocRelation,
   zDocRelationField,
   zDocRelationFile,
-  zDocSchema,
-  zDocSchemaField,
   zDocSchemaFieldBoolean,
-  zDocSchemaFieldMultiBoolean,
   zDocSchemaFieldMultiNumber,
   zDocSchemaFieldMultiRelation,
   zDocSchemaFieldMultiSelectNumber,
@@ -249,7 +369,6 @@ export {
   zDocSchemaFieldSelectNumber,
   zDocSchemaFieldSelectText,
   zDocSchemaFieldText,
-  zDocSchemaFieldType,
   zDocTreeDirectoryNode,
   zDocTreeFileNode,
   zDocTreeNode

package/debug/debug.ts

@@ -0,0 +1,40 @@
+import { DocClient } from "@/doc-client"
+import { DocFileSystem } from "@/doc-file-system"
+
+const client = new DocClient({
+  fileSystem: new DocFileSystem({ basePath: "../../docs" }),
+})
+
+const pagesRef = client.directory("docs-studio/pages", {
+  features: {
+    type: "multi-relation",
+    required: true,
+  },
+})
+
+const mdFileRef = await pagesRef.mdFile("document-editor")
+
+const mdFile = await mdFileRef.read()
+
+if (mdFile instanceof Error) {
+  throw mdFile
+}
+
+mdFile.withContent(
+  mdFile.content.withMetaProperty("features", [
+    "edit-document-content",
+    "delete-document",
+    "foo",
+  ]),
+)
+
+const relations = await mdFileRef.relations("features", {
+  "is-done": {
+    required: true,
+    type: "boolean",
+  },
+})
+
+const file = await relations[0].read()
+
+console.log("relations", file)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interactive-inc/docs-client",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "type": "module",
   "scripts": {
     "check": "tsgo --noEmit",
@@ -9,7 +9,7 @@
   },
   "dependencies": {
     "yaml": "^2.8.0",
-    "zod": "^3.25.74"
+    "zod": "^4.0.5"
   },
   "publishConfig": {
     "access": "public"