anpord 0.0.0 → 0.1.0

package/dist/client-bJBNwTKq.mjs

@@ -0,0 +1,236 @@
+import { FetchHttpClient, HttpApi, HttpApiClient, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware, HttpApiSchema, HttpApiSecurity, HttpClient, HttpClientRequest, OpenApi } from "@effect/platform";
+import { Context, Effect, Layer, Redacted, Schema } from "effect";
+//#region ../schema/src/domain/errors.ts
+var NotFound = class extends Schema.TaggedError()("NotFound", { message: Schema.String }, HttpApiSchema.annotations({ status: 404 })) {};
+var Conflict = class extends Schema.TaggedError()("Conflict", { message: Schema.String }, HttpApiSchema.annotations({ status: 409 })) {};
+var BadRequest = class extends Schema.TaggedError()("BadRequest", { message: Schema.String }, HttpApiSchema.annotations({ status: 400 })) {};
+var Unauthorized = class extends Schema.TaggedError()("Unauthorized", { message: Schema.String }, HttpApiSchema.annotations({ status: 401 })) {};
+Schema.TaggedError()("InternalError", { message: Schema.String }, HttpApiSchema.annotations({ status: 500 }));
+//#endregion
+//#region ../schema/src/internal/authentication.ts
+var CurrentActor = class extends Context.Tag("@anpord/schema/CurrentActor")() {};
+HttpApiMiddleware.Tag()("@anpord/schema/Authentication", {
+	failure: Unauthorized,
+	provides: CurrentActor,
+	security: { session: HttpApiSecurity.apiKey({
+		in: "cookie",
+		key: "anpord.session_token"
+	}) }
+});
+//#endregion
+//#region ../schema/src/public/authentication.ts
+var ApiKeyAuthentication = class extends HttpApiMiddleware.Tag()("@anpord/schema/ApiKeyAuthentication", {
+	failure: Unauthorized,
+	provides: CurrentActor,
+	security: { bearer: HttpApiSecurity.bearer }
+}) {};
+//#endregion
+//#region ../schema/src/domain/prompts.ts
+const ChannelName = Schema.String.pipe(Schema.minLength(1), Schema.maxLength(36), Schema.pattern(/^[a-z0-9][a-z0-9_-]*$/, { message: () => "Channel must be lowercase alphanumeric, optionally with - or _" }), Schema.brand("ChannelName")).annotations({ description: "Addresses a version. `latest` is derived from the highest version rather than stored, so it cannot drift from the version table." });
+ChannelName.make("production");
+ChannelName.make("latest");
+const PromptId = Schema.String.pipe(Schema.minLength(1), Schema.maxLength(255), Schema.pattern(/^[a-z0-9][a-z0-9/_-]*$/, { message: () => "Prompt id must be lowercase alphanumeric, optionally with / _ or -" }), Schema.brand("PromptId"));
+const PromptName = Schema.String.pipe(Schema.minLength(1), Schema.maxLength(255), Schema.brand("PromptName"));
+const VersionNumber = Schema.Int.pipe(Schema.positive(), Schema.brand("VersionNumber"));
+Schema.NumberFromString.pipe(Schema.int(), Schema.positive(), Schema.brand("VersionNumber"));
+Schema.NumberFromString.pipe(Schema.int(), Schema.positive(), Schema.lessThanOrEqualTo(100));
+const Timestamp = Schema.Union(Schema.DateFromSelf, Schema.Date);
+const CommitMessage = Schema.String.pipe(Schema.maxLength(500));
+const PromptConfig = Schema.Record({
+	key: Schema.String,
+	value: Schema.Unknown
+});
+const Author = Schema.Struct({
+	image: Schema.NullOr(Schema.String),
+	name: Schema.String
+});
+Schema.Struct({
+	author: Schema.NullOr(Author),
+	channel: Schema.NullOr(ChannelName),
+	commitMessage: Schema.NullOr(CommitMessage),
+	config: PromptConfig,
+	content: Schema.String,
+	createdAt: Timestamp,
+	id: PromptId,
+	name: PromptName,
+	version: VersionNumber,
+	versionId: Schema.String
+});
+Schema.Struct({
+	channel: ChannelName,
+	updatedAt: Timestamp,
+	updatedBy: Schema.NullOr(Author),
+	version: VersionNumber
+});
+const PromptSummary = Schema.Struct({
+	description: Schema.NullOr(Schema.String),
+	id: PromptId,
+	latestVersion: Schema.NullOr(VersionNumber),
+	name: PromptName,
+	productionVersion: Schema.NullOr(VersionNumber),
+	updatedAt: Timestamp
+});
+Schema.Struct({
+	id: PromptId,
+	updatedAt: Timestamp
+});
+Schema.Literal("all", "draft", "live");
+Schema.Literal("name", "updated");
+Schema.Struct({
+	items: Schema.Array(PromptSummary),
+	/** Opaque to callers, and null once the last page has been read. */
+	nextCursor: Schema.NullOr(Schema.String)
+});
+Schema.Struct({
+	commitMessage: Schema.optional(CommitMessage),
+	config: Schema.optional(PromptConfig),
+	content: Schema.String.pipe(Schema.minLength(1)),
+	description: Schema.optional(Schema.String),
+	id: PromptId,
+	name: PromptName,
+	publish: Schema.optional(Schema.Boolean)
+});
+Schema.Struct({
+	commitMessage: Schema.optional(CommitMessage),
+	config: Schema.optional(PromptConfig),
+	content: Schema.String.pipe(Schema.minLength(1)),
+	publish: Schema.optional(Schema.Boolean)
+});
+Schema.Struct({
+	commitMessage: Schema.optional(CommitMessage),
+	config: Schema.optional(PromptConfig),
+	content: Schema.String.pipe(Schema.minLength(1))
+});
+Schema.Struct({
+	description: Schema.optional(Schema.String),
+	id: Schema.optional(PromptId),
+	name: Schema.optional(PromptName)
+});
+Schema.Struct({
+	channel: ChannelName,
+	version: VersionNumber
+});
+Schema.Struct({
+	channel: Schema.optional(ChannelName),
+	version: Schema.optional(VersionNumber)
+});
+//#endregion
+//#region ../schema/src/public/requests.ts
+const GetPromptRequest = Schema.Struct({
+	channel: Schema.optional(ChannelName),
+	id: PromptId,
+	includeVersions: Schema.optional(Schema.Boolean),
+	version: Schema.optional(VersionNumber)
+}).annotations({
+	description: "Resolve a prompt. Give a version to pin one, a channel to follow one, or neither for production.",
+	identifier: "GetPromptRequest"
+});
+Schema.Struct({ id: PromptId }).annotations({
+	description: "Show a prompt's version history.",
+	identifier: "ListVersionsRequest"
+});
+const ListPromptsRequest = Schema.Struct({}).annotations({
+	description: "No parameters; returns every prompt in the organization.",
+	identifier: "ListPromptsRequest"
+});
+const CreatePromptRequest = Schema.Struct({
+	config: Schema.optional(PromptConfig),
+	content: Schema.String.pipe(Schema.minLength(1)),
+	description: Schema.optional(Schema.String),
+	id: PromptId,
+	message: Schema.optional(CommitMessage),
+	name: PromptName
+}).annotations({
+	description: "Create a prompt and its first version.",
+	identifier: "CreatePromptRequest"
+});
+const UpdatePromptRequest = Schema.Struct({
+	config: Schema.optional(PromptConfig),
+	content: Schema.String.pipe(Schema.minLength(1)),
+	id: PromptId,
+	message: Schema.optional(CommitMessage)
+}).annotations({
+	description: "Add a version to a prompt. The new version becomes the latest.",
+	identifier: "UpdatePromptRequest"
+});
+const PromotePromptRequest = Schema.Struct({
+	channel: ChannelName,
+	id: PromptId,
+	version: VersionNumber
+}).annotations({
+	description: "Point a channel at a version.",
+	identifier: "PromotePromptRequest"
+});
+const ArchivePromptRequest = Schema.Struct({ id: PromptId }).annotations({
+	description: "Archive a prompt. Existing versions stay readable by number.",
+	identifier: "ArchivePromptRequest"
+});
+const Ok = Schema.Struct({ ok: Schema.Literal(true) }).annotations({
+	description: "The operation succeeded.",
+	identifier: "Ok"
+});
+//#endregion
+//#region ../schema/src/public/shapes.ts
+const Instant = Schema.DateTimeUtc.annotations({
+	description: "An ISO-8601 timestamp in UTC.",
+	identifier: "Instant"
+});
+const PublicPrompt = Schema.Struct({
+	channel: Schema.NullOr(ChannelName),
+	config: PromptConfig,
+	content: Schema.String,
+	createdAt: Instant,
+	id: PromptId,
+	message: Schema.NullOr(CommitMessage),
+	name: PromptName,
+	version: VersionNumber
+}).annotations({
+	description: "A prompt resolved at a specific version.",
+	identifier: "ResolvedPrompt"
+});
+const PublicVersion = Schema.Struct({
+	createdAt: Instant,
+	message: Schema.NullOr(CommitMessage),
+	version: VersionNumber
+}).annotations({
+	description: "One entry in a prompt's history.",
+	identifier: "Version"
+});
+const PublicPromptWithVersions = Schema.extend(PublicPrompt, Schema.Struct({ versions: Schema.optional(Schema.Array(PublicVersion)) })).annotations({
+	description: "A prompt, with its version history when `includeVersions` is set.",
+	identifier: "Prompt"
+});
+const PublicPromptSummary = Schema.Struct({
+	id: PromptId,
+	latestVersion: Schema.NullOr(VersionNumber),
+	name: PromptName,
+	productionVersion: Schema.NullOr(VersionNumber),
+	updatedAt: Instant
+}).annotations({
+	description: "A prompt without its content.",
+	identifier: "PromptSummary"
+});
+const PromptList = Schema.Struct({ data: Schema.Array(PublicPromptSummary) }).annotations({
+	description: "Every prompt in the organization.",
+	identifier: "PromptList"
+});
+//#endregion
+//#region ../schema/src/public/prompts-api.ts
+var PublicPromptsGroup = class extends HttpApiGroup.make("prompts").add(HttpApiEndpoint.post("get", "/prompts.get").setPayload(GetPromptRequest).addSuccess(PublicPromptWithVersions).annotate(OpenApi.Summary, "Resolve a prompt").annotate(OpenApi.Description, "Returns the content a caller should send to a model. With no selector this is the production version.")).add(HttpApiEndpoint.post("list", "/prompts.list").setPayload(ListPromptsRequest).addSuccess(PromptList).annotate(OpenApi.Summary, "List prompts").annotate(OpenApi.Description, "Every prompt in the organization, without content.")).add(HttpApiEndpoint.post("create", "/prompts.create").setPayload(CreatePromptRequest).addSuccess(PublicPromptWithVersions).annotate(OpenApi.Summary, "Create a prompt").annotate(OpenApi.Description, "Creates the prompt and its first version in one call.")).add(HttpApiEndpoint.post("update", "/prompts.update").setPayload(UpdatePromptRequest).addSuccess(PublicPromptWithVersions).annotate(OpenApi.Summary, "Add a version").annotate(OpenApi.Description, "Content is versioned, so updating a prompt appends a version rather than overwriting one. Earlier versions stay readable.")).add(HttpApiEndpoint.post("promote", "/prompts.promote").setPayload(PromotePromptRequest).addSuccess(Ok).annotate(OpenApi.Summary, "Promote a version to a channel").annotate(OpenApi.Description, "Points a channel, such as production, at a version. This is how a version goes live without callers changing anything.")).add(HttpApiEndpoint.post("archive", "/prompts.archive").setPayload(ArchivePromptRequest).addSuccess(Ok).annotate(OpenApi.Summary, "Archive a prompt").annotate(OpenApi.Description, "Hides the prompt from listings. Pinned versions keep resolving.")).addError(BadRequest).addError(Conflict).addError(NotFound).middleware(ApiKeyAuthentication).annotate(OpenApi.Title, "Prompts").annotate(OpenApi.Description, "Read and write prompts. Content is versioned, so writes append rather than overwrite, and channels decide which version callers receive.") {};
+//#endregion
+//#region ../schema/src/public/api.ts
+var PublicApi = class extends HttpApi.make("anpord-public").add(PublicPromptsGroup).prefix("/v1").annotate(OpenApi.Title, "Anpord API").annotate(OpenApi.Version, "1.0.0").annotate(OpenApi.Description, "Prompt management. Every endpoint takes a JSON body over POST and authenticates with a bearer API key.").annotate(OpenApi.Servers, [{
+	description: "Production",
+	url: "https://api.anpord.com"
+}]) {};
+//#endregion
+//#region ../schema/src/public/client.ts
+const DEFAULT_BASE_URL = "https://api.anpord.com";
+const make = ({ apiKey, baseUrl = DEFAULT_BASE_URL }) => HttpApiClient.make(PublicApi, {
+	baseUrl,
+	transformClient: HttpClient.mapRequest(HttpClientRequest.bearerToken(Redacted.value(apiKey)))
+});
+var AnpordApi = class extends Effect.Tag("@anpord/sdk/AnpordApi")() {};
+const layer = (options) => Layer.effect(AnpordApi, make(options)).pipe(Layer.provide(FetchHttpClient.layer));
+//#endregion
+export { ChannelName as a, make as i, DEFAULT_BASE_URL as n, PromptId as o, layer as r, VersionNumber as s, AnpordApi as t };

package/dist/config.cjs

@@ -0,0 +1,14 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_client = require("./client-Cno4LwRq.cjs");
+let effect = require("effect");
+//#region src/client/config.ts
+const apiKeyConfig = effect.Config.redacted("ANPORD_API_KEY");
+const baseUrlConfig = effect.Config.string("ANPORD_BASE_URL").pipe(effect.Config.withDefault(require_client.DEFAULT_BASE_URL));
+const clientOptionsConfig = effect.Config.all({
+	apiKey: apiKeyConfig,
+	baseUrl: baseUrlConfig
+});
+//#endregion
+exports.apiKeyConfig = apiKeyConfig;
+exports.baseUrlConfig = baseUrlConfig;
+exports.clientOptionsConfig = clientOptionsConfig;

package/dist/config.d.cts

@@ -0,0 +1,10 @@
+import { Config } from "effect";
+//#region src/client/config.d.ts
+declare const apiKeyConfig: Config.Config<import("effect/Redacted").Redacted<string>>;
+declare const baseUrlConfig: Config.Config<string>;
+declare const clientOptionsConfig: Config.Config<{
+  apiKey: import("effect/Redacted").Redacted<string>;
+  baseUrl: string;
+}>;
+//#endregion
+export { apiKeyConfig, baseUrlConfig, clientOptionsConfig };

package/dist/config.d.mts

@@ -0,0 +1,10 @@
+import { Config } from "effect";
+//#region src/client/config.d.ts
+declare const apiKeyConfig: Config.Config<import("effect/Redacted").Redacted<string>>;
+declare const baseUrlConfig: Config.Config<string>;
+declare const clientOptionsConfig: Config.Config<{
+  apiKey: import("effect/Redacted").Redacted<string>;
+  baseUrl: string;
+}>;
+//#endregion
+export { apiKeyConfig, baseUrlConfig, clientOptionsConfig };

package/dist/config.mjs

@@ -0,0 +1,11 @@
+import { n as DEFAULT_BASE_URL } from "./client-bJBNwTKq.mjs";
+import { Config } from "effect";
+//#region src/client/config.ts
+const apiKeyConfig = Config.redacted("ANPORD_API_KEY");
+const baseUrlConfig = Config.string("ANPORD_BASE_URL").pipe(Config.withDefault(DEFAULT_BASE_URL));
+const clientOptionsConfig = Config.all({
+	apiKey: apiKeyConfig,
+	baseUrl: baseUrlConfig
+});
+//#endregion
+export { apiKeyConfig, baseUrlConfig, clientOptionsConfig };

package/dist/errors-C0E5A8fN.cjs

@@ -0,0 +1,67 @@
+let effect_ParseResult = require("effect/ParseResult");
+//#region src/client/errors.ts
+var MissingApiKey = class extends Error {
+	name = "MissingApiKey";
+	constructor() {
+		super("No API key. Pass { apiKey } to the Anpord constructor or set ANPORD_API_KEY.");
+	}
+};
+var AnpordError = class extends Error {
+	name = "AnpordError";
+	status;
+	cause;
+	constructor(message, options) {
+		super(message);
+		this.cause = options.cause;
+		this.status = options.status;
+	}
+};
+const statusOf = (error) => {
+	if (typeof error !== "object" || error === null) return;
+	switch (error._tag) {
+		case "BadRequest": return 400;
+		case "Unauthorized": return 401;
+		case "NotFound": return 404;
+		case "Conflict": return 409;
+		case "InternalError": return 500;
+		default: return;
+	}
+};
+const rejectedFields = (error) => {
+	if (error._tag !== "ParseError") return;
+	return effect_ParseResult.ArrayFormatter.formatErrorSync(error).map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
+};
+const messageOf = (error) => {
+	if (typeof error === "object" && error !== null) {
+		const rejected = rejectedFields(error);
+		if (rejected) return rejected;
+		const message = error.message;
+		if (typeof message === "string" && message.length > 0) return message;
+		const tag = error._tag;
+		if (typeof tag === "string") return tag;
+	}
+	return "The request failed.";
+};
+const asAnpordError = (error) => error instanceof AnpordError ? error : new AnpordError(messageOf(error), {
+	cause: error,
+	status: statusOf(error)
+});
+//#endregion
+Object.defineProperty(exports, "AnpordError", {
+	enumerable: true,
+	get: function() {
+		return AnpordError;
+	}
+});
+Object.defineProperty(exports, "MissingApiKey", {
+	enumerable: true,
+	get: function() {
+		return MissingApiKey;
+	}
+});
+Object.defineProperty(exports, "asAnpordError", {
+	enumerable: true,
+	get: function() {
+		return asAnpordError;
+	}
+});

package/dist/errors-DEfS6oaQ.mjs

@@ -0,0 +1,50 @@
+import { ArrayFormatter } from "effect/ParseResult";
+//#region src/client/errors.ts
+var MissingApiKey = class extends Error {
+	name = "MissingApiKey";
+	constructor() {
+		super("No API key. Pass { apiKey } to the Anpord constructor or set ANPORD_API_KEY.");
+	}
+};
+var AnpordError = class extends Error {
+	name = "AnpordError";
+	status;
+	cause;
+	constructor(message, options) {
+		super(message);
+		this.cause = options.cause;
+		this.status = options.status;
+	}
+};
+const statusOf = (error) => {
+	if (typeof error !== "object" || error === null) return;
+	switch (error._tag) {
+		case "BadRequest": return 400;
+		case "Unauthorized": return 401;
+		case "NotFound": return 404;
+		case "Conflict": return 409;
+		case "InternalError": return 500;
+		default: return;
+	}
+};
+const rejectedFields = (error) => {
+	if (error._tag !== "ParseError") return;
+	return ArrayFormatter.formatErrorSync(error).map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
+};
+const messageOf = (error) => {
+	if (typeof error === "object" && error !== null) {
+		const rejected = rejectedFields(error);
+		if (rejected) return rejected;
+		const message = error.message;
+		if (typeof message === "string" && message.length > 0) return message;
+		const tag = error._tag;
+		if (typeof tag === "string") return tag;
+	}
+	return "The request failed.";
+};
+const asAnpordError = (error) => error instanceof AnpordError ? error : new AnpordError(messageOf(error), {
+	cause: error,
+	status: statusOf(error)
+});
+//#endregion
+export { MissingApiKey as n, asAnpordError as r, AnpordError as t };

package/dist/index.cjs

@@ -1,9 +1,35 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/index.ts
-/**
-* Placeholder release. The client lands in a future version — this exists so
-* the package name is reserved and consumers can pin something real.
-*/
-const VERSION = "0.0.0";
+const require_client = require("./client-Cno4LwRq.cjs");
+const require_errors = require("./errors-C0E5A8fN.cjs");
+let _effect_platform = require("@effect/platform");
+let effect = require("effect");
+//#region src/client/anpord.ts
+const resolveApiKey = (provided) => {
+	const apiKey = provided ?? globalThis.process?.env?.ANPORD_API_KEY;
+	if (!apiKey) throw new require_errors.MissingApiKey();
+	return apiKey;
+};
+var Anpord = class {
+	prompts;
+	constructor(options = {}) {
+		const apiKey = resolveApiKey(options.apiKey);
+		const client = require_client.make({
+			apiKey: effect.Redacted.make(apiKey),
+			baseUrl: options.baseUrl ?? "https://api.anpord.com"
+		}).pipe(effect.Effect.provide(_effect_platform.FetchHttpClient.layer), effect.Effect.runSync);
+		this.prompts = promised(client.prompts);
+	}
+};
+const promised = (group) => Object.fromEntries(Object.entries(group).map(([method, run]) => [method, async (request) => {
+	const exit = await effect.Effect.runPromiseExit(run({ payload: request ?? {} }));
+	if (effect.Exit.isSuccess(exit)) return exit.value;
+	throw require_errors.asAnpordError(effect.Cause.failureOption(exit.cause).pipe(effect.Option.getOrElse(() => effect.Cause.squash(exit.cause))));
+}]));
 //#endregion
-exports.VERSION = VERSION;
+exports.Anpord = Anpord;
+exports.AnpordApi = require_client.AnpordApi;
+exports.AnpordError = require_errors.AnpordError;
+exports.DEFAULT_BASE_URL = require_client.DEFAULT_BASE_URL;
+exports.MissingApiKey = require_errors.MissingApiKey;
+exports.layer = require_client.layer;
+exports.make = require_client.make;