@repome/api 0.1.7 → 0.1.9

package/dist/index.mjs

@@ -12,6 +12,11 @@ const commonErrors = {
 		message: "Sign in required",
 		data: z.object({}).optional()
 	},
+	TOO_MANY_REQUESTS: {
+		status: 429,
+		message: "Too many requests",
+		data: z.object({ retryAfterMs: z.number().int().nonnegative().optional() }).optional()
+	},
 	FORBIDDEN: {
 		status: 403,
 		message: "You do not have access to this resource",
@@ -26,6 +31,11 @@ const commonErrors = {
 		message: "Invitation not found",
 		data: z.object({ invitationId: z.string() })
 	},
+	KEY_NOT_FOUND: {
+		status: 404,
+		message: "API key not found",
+		data: z.object({ id: z.string() })
+	},
 	REPO_NOT_FOUND: {
 		status: 404,
 		message: "Repo not found",
@@ -131,7 +141,8 @@ const ocBase = oc.errors(commonErrors);
 //#region src/orgs.ts
 const orgSlugHint = "Lowercase, alphanumeric, - only.";
 const orgSlugSchema = z.string().min(1).max(64).regex(/^[a-z0-9][a-z0-9-]*$/, orgSlugHint);
-const repoScopeSchema = z.object({ orgSlug: orgSlugSchema.optional() });
+const PERSONAL_ORG_SLUG = "~";
+const repoScopeSchema = z.object({ orgSlug: z.union([orgSlugSchema, z.literal("~")]).optional() });
 const orgIdOrSlugSchema = z.object({ idOrSlug: z.string().min(1) });
 const orgCreateInputSchema = z.object({
 	slug: orgSlugSchema,
@@ -153,8 +164,12 @@ const orgs = {
 	delete: ocBase.input(orgIdOrSlugSchema).output(z.object({ deleted: z.literal(true) }))
 };
 //#endregion
+//#region src/pagination.ts
+const cursorSchema = z.string().optional().describe("Opaque pagination cursor from a previous page. Lenient: an undecodable cursor restarts from the first page; a stale cursor (pointing at a removed item) yields an empty page on git listings and continues past the cursor position on catalog listings. Never an error.");
+//#endregion
 //#region src/repos.ts
 const repoNameHint = "Lowercase, alphanumeric, ._- only.";
+const CLONE_TOKEN_SCOPE = "read";
 const repoNameSchema = z.string().min(1).max(64).regex(/^[a-z0-9][a-z0-9._-]*$/, repoNameHint);
 function parseRepoName(value) {
 	return repoNameSchema.parse(value);
@@ -171,7 +186,7 @@ const repoUpdateInputSchema = repoIdentSchema.extend({
 	defaultBranch: z.string().min(1).max(128).optional()
 });
 const repoListInputSchema = repoScopeSchema.extend({
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(100).default(50)
 });
 const repoSchema = z.object({
@@ -190,7 +205,8 @@ const repoSchema = z.object({
 	updatedAt: z.number()
 });
 const repoCreateOutputSchema = repoSchema.extend({
-	token: z.string(),
+	token: z.string().describe("Convenience token bundled with the new repo. Read/clone-scoped: it cannot push. Mint a write token (tokens.mint, scope \"write\") or use the repome git credential helper for the first push."),
+	tokenScope: z.literal(CLONE_TOKEN_SCOPE),
 	tokenExpiresAt: z.string()
 });
 const repoListOutputSchema = z.object({
@@ -215,7 +231,7 @@ const repos = {
 //#region src/git.ts
 const pageInputSchema = repoScopeSchema.extend({
 	name: repoNameSchema,
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(100).default(50)
 });
 const refInputSchema = repoScopeSchema.extend({
@@ -231,7 +247,7 @@ const treeInputSchema = repoScopeSchema.extend({
 	ref: z.string().min(1).default("HEAD"),
 	path: z.string().optional(),
 	recursive: z.boolean().default(true),
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(100).default(50)
 });
 const blobInputSchema = repoScopeSchema.extend({
@@ -305,7 +321,7 @@ const compareInputSchema = repoScopeSchema.extend({
 	name: repoNameSchema,
 	base: z.string().min(1),
 	head: z.string().min(1),
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(250).default(250)
 });
 const diffInputSchema = repoScopeSchema.extend({
@@ -314,7 +330,7 @@ const diffInputSchema = repoScopeSchema.extend({
 	head: z.string().min(1),
 	path: z.string().optional(),
 	includePatch: z.boolean().default(false),
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(250).default(50)
 });
 const gitRefSchema = z.object({
@@ -490,7 +506,7 @@ const tokens = {
 //#region src/anon.ts
 const anonRepoIdentSchema = z.object({ name: repoNameSchema });
 const anonPageInputSchema = anonRepoIdentSchema.extend({
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(100).default(50)
 });
 const anonRefInputSchema = anonRepoIdentSchema.extend({ ref: z.string().min(1) });
@@ -498,7 +514,7 @@ const anonTreeInputSchema = anonRepoIdentSchema.extend({
 	ref: z.string().min(1).default("HEAD"),
 	path: z.string().optional(),
 	recursive: z.boolean().default(true),
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(100).default(50)
 });
 const anonBlobInputSchema = anonRepoIdentSchema.extend({ oid: z.string().min(1) });
@@ -506,7 +522,7 @@ const anonRepoCreateInputSchema = z.object({
 	name: repoNameSchema.optional(),
 	description: z.string().max(512).optional(),
 	defaultBranch: z.string().min(1).max(128).default("main"),
-	ttlSeconds: z.number().int().min(0).max(86400 * 30).optional()
+	ttlSeconds: z.number().int().min(60).max(3600 * 72).optional()
 });
 const anonRepoSchema = repoSchema.extend({
 	expiresAt: z.string(),
@@ -514,7 +530,7 @@ const anonRepoSchema = repoSchema.extend({
 });
 const anonRepoCreateOutputSchema = anonRepoSchema.extend({ anonId: z.string() });
 const anonRepoListInputSchema = z.object({
-	cursor: z.string().optional(),
+	cursor: cursorSchema,
 	limit: z.number().int().min(1).max(100).default(50)
 });
 const anonRepoListOutputSchema = z.object({
@@ -657,10 +673,13 @@ const invitationViewSchema = z.object({
 	inviterId: z.string(),
 	expiresAt: z.number()
 });
+const invitationListItemSchema = invitationViewSchema.extend({ createdAt: z.number() });
 const orgInputSchema = z.object({ orgSlug: orgSlugSchema });
 const memberListOutputSchema = z.object({ items: z.array(memberViewSchema) });
+const invitationListOutputSchema = z.object({ items: z.array(invitationListItemSchema) });
 const members = {
 	list: ocBase.input(orgInputSchema).output(memberListOutputSchema),
+	listInvitations: ocBase.input(orgInputSchema).output(invitationListOutputSchema),
 	invite: ocBase.input(orgInputSchema.extend({
 		email: z.email(),
 		role: mutableMemberRoleSchema
@@ -732,4 +751,4 @@ const contract = {
 	tokens
 };
 //#endregion
-export { ANON_ID_STORE_VERSION, anonRepoSchema, apiKeyViewSchema, commonErrors, compareViewSchema, contract, diffFileSchema, diffViewSchema, gitBlobSchema, gitCommitSchema, gitRefSchema, gitTreeEntrySchema, invitationViewSchema, meViewSchema, memberRoleSchema, memberViewSchema, mutableMemberRoleSchema, orgSlugHint, orgSlugSchema, orgViewSchema, parseAnonIdFile, parseRepoName, repoNameHint, repoNameSchema, repoSchema, scopeSchema, serializeAnonIdRecord, tokenScopeSchema, tokenViewSchema };
+export { ANON_ID_STORE_VERSION, CLONE_TOKEN_SCOPE, PERSONAL_ORG_SLUG, anonRepoSchema, apiKeyViewSchema, commonErrors, compareViewSchema, contract, cursorSchema, diffFileSchema, diffViewSchema, gitBlobSchema, gitCommitSchema, gitRefSchema, gitTreeEntrySchema, invitationListItemSchema, invitationViewSchema, meViewSchema, memberRoleSchema, memberViewSchema, mutableMemberRoleSchema, orgSlugHint, orgSlugSchema, orgViewSchema, parseAnonIdFile, parseRepoName, repoNameHint, repoNameSchema, repoSchema, scopeSchema, serializeAnonIdRecord, tokenScopeSchema, tokenViewSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repome/api",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Agent-native, GitHub-shaped forge — shared oRPC contract (zod schemas + procedure shapes).",
   "keywords": [
     "agent",