blodemd 0.0.11 → 0.0.13

package/packages/@repo/previewing/dist/index.d.ts

@@ -12,6 +12,8 @@ export declare const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
 export declare const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export declare const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export declare const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export declare const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export declare const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
 export declare const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
 export declare const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 export type SiteConfigResult = {
@@ -82,6 +84,7 @@ export interface UtilityIndex {
     description?: string;
     name: string;
     pages: UtilityPage[];
+    slug?: string;
 }
 export interface UtilityArtifact {
     content: string;

package/packages/@repo/previewing/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,WAAW,EAEX,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACX,MAAM,cAAc,CAAC;AAQtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AACpE,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAC9D,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,kCAAkC,+BAA+B,CAAC;AAC/E,eAAO,MAAM,iCAAiC,qBAAqB,CAAC;AACpE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,oCAAoC,wGACsD,CAAC;AAExG,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;CAC7C,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;CACnB;AAID,eAAO,MAAM,oBAAoB,GAC/B,OAAO,YAAY,KAClB,GAAG,CAAC,MAAM,EAAE,YAAY,CAoD1B,CAAC;AAoTF,eAAO,MAAM,cAAc,GACzB,QAAQ,aAAa,KACpB,OAAO,CAAC,gBAAgB,CAU1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,aAAa,EACrB,cAAc,MAAM,oBACkB,CAAC;AAyLzC,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,aAAa,EACrB,QAAQ,UAAU,KACjB,OAAO,CAAC,YAAY,CAkFtB,CAAC;AAuCF,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,OAAO,EAwBlD,CAAC;AAiBF,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,WAO/D,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,KAAK,MAAM,EACX,QAAQ,MAAM,WAQf,CAAC;AA2QF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,YAAY,EACnB,QAAQ,UAAU,EAClB,eAAe,YAAY,KAC1B,eAAe,EAyBjB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,OAAO,YAAY,EACnB,QAAQ,aAAa,EACrB,QAAQ,UAAU,KACjB,OAAO,CAAC,YAAY,CAwCtB,CAAC;AAaF,eAAO,MAAM,6BAA6B,GAAI,MAAM,MAAM,WAGzD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,YAAY,KAClB,eAAe,EA2GjB,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,YAAY,EACnB,QAAQ,aAAa,KACpB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAahC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,YAAY,KAAG,MAKvB,CAAC;AAEtC,eAAO,MAAM,qBAAqB,GAChC,SAAS,oBAAoB,EAAE,KAC9B,MAIkC,CAAC;AAEtC,eAAO,MAAM,wBAAwB,GACnC,QAAQ,aAAa,KACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CA8B7B,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,aAAa,KACpB,OAAO,CAAC,oBAAoB,EAAE,GAAG,IAAI,CAYvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,eAAe,EAAE,KAAG,MAI5B,CAAC;AAErC,eAAO,MAAM,uBAAuB,GAClC,QAAQ,aAAa,KACpB,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAYlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,KAClC,MAI8B,CAAC;AAElC,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,aAAa,KACpB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAYvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,YAAY,KAAG,MAIvB,CAAC;AAEtC,eAAO,MAAM,wBAAwB,GACnC,QAAQ,aAAa,KACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CAoB7B,CAAC"}

package/packages/@repo/previewing/dist/index.js

@@ -14,6 +14,8 @@ export const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
 export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
 export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
 export const LEGACY_PROJECT_NAME_FALLBACK_WARNING = "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
 const validModes = new Set(PageModeSchema.options);
@@ -780,6 +782,7 @@ export const buildUtilityIndex = async (index, source, config) => {
         description: config.description,
         name: config.name,
         pages: sortedPages,
+        slug: config.slug,
     };
 };
 const toUtilityDocPath = (value) => {
@@ -800,6 +803,7 @@ export const buildUtilityArtifacts = (index) => {
         index.description ? `> ${index.description}` : null,
         "",
         `Sitemap: ${toUtilityTemplatedDocUrl("sitemap.xml")}`,
+        `Skills: ${UTILITY_DOCS_ROOT_TOKEN}/.well-known/skills/index.json`,
         "",
         "## Docs",
         ...index.pages.map((page) => {
@@ -816,6 +820,40 @@ ${index.pages
     const llmsFull = index.pages
         .map((page) => formatMarkdownPageSection(page.title, toUtilityTemplatedDocUrl(page.slug), page.content))
         .join("\n\n");
+    const skillSlug = index.slug ?? slugify(index.name);
+    const skillDescription = `${index.name} documentation. ${index.description ?? ""}`.trim();
+    const skillsIndex = JSON.stringify({
+        skills: [
+            {
+                description: skillDescription,
+                files: ["SKILL.md"],
+                name: skillSlug,
+            },
+        ],
+    }, null, 2);
+    const topPages = index.pages.slice(0, 20);
+    const skillMdLines = [
+        "---",
+        `name: ${skillSlug}`,
+        `description: ${skillDescription} Use when working with ${index.name}, answering questions about its features, or helping users follow its guides.`,
+        "---",
+        "",
+        `# ${index.name}`,
+        "",
+        index.description ? `${index.description}\n` : "",
+        "## Documentation",
+        "",
+        `- Full docs index: ${UTILITY_DOCS_ROOT_TOKEN}/llms.txt`,
+        `- Complete docs content: ${UTILITY_DOCS_ROOT_TOKEN}/llms-full.txt`,
+        "- Append `.md` to any page URL for raw markdown",
+        "",
+        "## Key Pages",
+        "",
+        ...topPages.map((page) => {
+            const desc = page.description ? ` - ${page.description}` : "";
+            return `- [${page.title}](${toUtilityTemplatedDocUrl(page.slug)})${desc}`;
+        }),
+    ];
     return [
         {
             content: sitemap,
@@ -832,6 +870,16 @@ ${index.pages
             contentType: "text/plain; charset=utf-8",
             path: PREBUILT_UTILITY_LLMS_FULL_PATH,
         },
+        {
+            content: skillsIndex,
+            contentType: "application/json; charset=utf-8",
+            path: PREBUILT_UTILITY_SKILLS_INDEX_PATH,
+        },
+        {
+            content: skillMdLines.filter((line) => line !== null).join("\n"),
+            contentType: "text/markdown; charset=utf-8",
+            path: `${PREBUILT_UTILITY_SKILLS_MD_PREFIX}${skillSlug}/SKILL.md`,
+        },
         ...index.pages.map((page) => ({
             content: formatMarkdownPage(page.title, page.content),
             contentType: "text/markdown; charset=utf-8",

package/packages/@repo/previewing/package.json

@@ -5,12 +5,12 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
     "./*": {
-      "types": "./src/*.ts",
+      "types": "./dist/*.d.ts",
       "import": "./dist/*.js",
       "default": "./dist/*.js"
     }

package/packages/@repo/previewing/src/index.ts

@@ -39,6 +39,8 @@ export const PREBUILT_UTILITY_INDEX_PATH = "_utility-index.json";
 export const PREBUILT_UTILITY_SITEMAP_PATH = "_utility/sitemap.xml";
 export const PREBUILT_UTILITY_LLMS_PATH = "_utility/llms.txt";
 export const PREBUILT_UTILITY_LLMS_FULL_PATH = "_utility/llms-full.txt";
+export const PREBUILT_UTILITY_SKILLS_INDEX_PATH = "_utility/skills-index.json";
+export const PREBUILT_UTILITY_SKILLS_MD_PREFIX = "_utility/skills/";
 export const UTILITY_DOCS_ROOT_TOKEN = "__BLODEMD_DOCS_ROOT__";
 export const LEGACY_PROJECT_NAME_FALLBACK_WARNING =
   "docs.json.slug is recommended. Falling back to docs.json.name as the deployment slug is deprecated.";
@@ -115,6 +117,7 @@ export interface UtilityIndex {
   description?: string;
   name: string;
   pages: UtilityPage[];
+  slug?: string;
 }
 
 export interface UtilityArtifact {
@@ -1223,6 +1226,7 @@ export const buildUtilityIndex = async (
     description: config.description,
     name: config.name,
     pages: sortedPages,
+    slug: config.slug,
   };
 };
 
@@ -1250,6 +1254,7 @@ export const buildUtilityArtifacts = (
     index.description ? `> ${index.description}` : null,
     "",
     `Sitemap: ${toUtilityTemplatedDocUrl("sitemap.xml")}`,
+    `Skills: ${UTILITY_DOCS_ROOT_TOKEN}/.well-known/skills/index.json`,
     "",
     "## Docs",
     ...index.pages.map((page) => {
@@ -1277,6 +1282,47 @@ ${index.pages
     )
     .join("\n\n");
 
+  const skillSlug = index.slug ?? slugify(index.name);
+  const skillDescription =
+    `${index.name} documentation. ${index.description ?? ""}`.trim();
+  const skillsIndex = JSON.stringify(
+    {
+      skills: [
+        {
+          description: skillDescription,
+          files: ["SKILL.md"],
+          name: skillSlug,
+        },
+      ],
+    },
+    null,
+    2
+  );
+
+  const topPages = index.pages.slice(0, 20);
+  const skillMdLines = [
+    "---",
+    `name: ${skillSlug}`,
+    `description: ${skillDescription} Use when working with ${index.name}, answering questions about its features, or helping users follow its guides.`,
+    "---",
+    "",
+    `# ${index.name}`,
+    "",
+    index.description ? `${index.description}\n` : "",
+    "## Documentation",
+    "",
+    `- Full docs index: ${UTILITY_DOCS_ROOT_TOKEN}/llms.txt`,
+    `- Complete docs content: ${UTILITY_DOCS_ROOT_TOKEN}/llms-full.txt`,
+    "- Append `.md` to any page URL for raw markdown",
+    "",
+    "## Key Pages",
+    "",
+    ...topPages.map((page) => {
+      const desc = page.description ? ` - ${page.description}` : "";
+      return `- [${page.title}](${toUtilityTemplatedDocUrl(page.slug)})${desc}`;
+    }),
+  ];
+
   return [
     {
       content: sitemap,
@@ -1293,6 +1339,16 @@ ${index.pages
       contentType: "text/plain; charset=utf-8",
       path: PREBUILT_UTILITY_LLMS_FULL_PATH,
     },
+    {
+      content: skillsIndex,
+      contentType: "application/json; charset=utf-8",
+      path: PREBUILT_UTILITY_SKILLS_INDEX_PATH,
+    },
+    {
+      content: skillMdLines.filter((line) => line !== null).join("\n"),
+      contentType: "text/markdown; charset=utf-8",
+      path: `${PREBUILT_UTILITY_SKILLS_MD_PREFIX}${skillSlug}/SKILL.md`,
+    },
     ...index.pages.map((page) => ({
       content: formatMarkdownPage(page.title, page.content),
       contentType: "text/markdown; charset=utf-8",

package/packages/@repo/validation/package.json

@@ -5,12 +5,12 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
     "./*": {
-      "types": "./src/*.ts",
+      "types": "./dist/*.d.ts",
       "import": "./dist/*.js",
       "default": "./dist/*.js"
     }

package/packages/@repo/validation/src/blodemd-docs-schema.json

@@ -3476,6 +3476,7 @@
                   "cursor",
                   "devin",
                   "devin-mcp",
+                  "gemini",
                   "grok",
                   "mcp",
                   "perplexity",

package/scripts/prepare-package.mjs

@@ -5,6 +5,8 @@ import { existsSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
+import { REPO_PACKAGES } from "./repo-packages.mjs";
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const cliRoot = path.resolve(__dirname, "..");
 const repoRoot = path.resolve(cliRoot, "../..");
@@ -28,6 +30,18 @@ if (!shouldPackage && !isGlobalInstall) {
 
 console.log("Preparing blodemd standalone package...");
 
+// Build @repo/* workspace packages first so tsdown can inline their dist/
+// output into the CLI bundle. Without this, tsdown falls back to treating
+// `@repo/common` etc. as external imports and the published tarball ships
+// unresolved imports that break `npx blodemd`.
+console.log("Building @repo packages...");
+for (const pkg of REPO_PACKAGES) {
+  execSync("npm run build", {
+    cwd: path.join(repoRoot, `packages/${pkg}`),
+    stdio: "inherit",
+  });
+}
+
 execSync("npm run build", {
   cwd: cliRoot,
   stdio: "inherit",

package/packages/@repo/contracts/dist/api-key.d.ts

@@ -1,30 +0,0 @@
-import { z } from "zod";
-export declare const ApiKeySchema: z.ZodObject<{
-    createdAt: z.ZodString;
-    id: z.ZodString;
-    lastUsedAt: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    prefix: z.ZodString;
-    projectId: z.ZodString;
-    revokedAt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type ApiKey = z.infer<typeof ApiKeySchema>;
-export declare const ApiKeyCreateSchema: z.ZodObject<{
-    name: z.ZodString;
-    projectId: z.ZodString;
-}, z.core.$strip>;
-export type ApiKeyCreateInput = z.infer<typeof ApiKeyCreateSchema>;
-export declare const ApiKeyCreateResponseSchema: z.ZodObject<{
-    apiKey: z.ZodObject<{
-        createdAt: z.ZodString;
-        id: z.ZodString;
-        lastUsedAt: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-        prefix: z.ZodString;
-        projectId: z.ZodString;
-        revokedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    token: z.ZodString;
-}, z.core.$strip>;
-export type ApiKeyCreateResponse = z.infer<typeof ApiKeyCreateResponseSchema>;
-//# sourceMappingURL=api-key.d.ts.map

package/packages/@repo/contracts/dist/api-key.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../src/api-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,YAAY;;;;;;;;iBAQvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,eAAO,MAAM,0BAA0B;;;;;;;;;;;iBAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/packages/@repo/contracts/dist/api-key.js

@@ -1,20 +0,0 @@
-import { z } from "zod";
-import { IsoDateSchema } from "./dates.js";
-import { IdSchema } from "./ids.js";
-export const ApiKeySchema = z.object({
-    createdAt: IsoDateSchema,
-    id: IdSchema,
-    lastUsedAt: IsoDateSchema.optional(),
-    name: z.string().min(1),
-    prefix: z.string().min(1),
-    projectId: IdSchema,
-    revokedAt: IsoDateSchema.optional(),
-});
-export const ApiKeyCreateSchema = z.object({
-    name: z.string().min(1),
-    projectId: IdSchema,
-});
-export const ApiKeyCreateResponseSchema = z.object({
-    apiKey: ApiKeySchema,
-    token: z.string().min(1),
-});

package/packages/@repo/contracts/src/api-key.ts

@@ -1,27 +0,0 @@
-import { z } from "zod";
-
-import { IsoDateSchema } from "./dates.js";
-import { IdSchema } from "./ids.js";
-
-export const ApiKeySchema = z.object({
-  createdAt: IsoDateSchema,
-  id: IdSchema,
-  lastUsedAt: IsoDateSchema.optional(),
-  name: z.string().min(1),
-  prefix: z.string().min(1),
-  projectId: IdSchema,
-  revokedAt: IsoDateSchema.optional(),
-});
-export type ApiKey = z.infer<typeof ApiKeySchema>;
-
-export const ApiKeyCreateSchema = z.object({
-  name: z.string().min(1),
-  projectId: IdSchema,
-});
-export type ApiKeyCreateInput = z.infer<typeof ApiKeyCreateSchema>;
-
-export const ApiKeyCreateResponseSchema = z.object({
-  apiKey: ApiKeySchema,
-  token: z.string().min(1),
-});
-export type ApiKeyCreateResponse = z.infer<typeof ApiKeyCreateResponseSchema>;