@tinkerer/sdk 0.1.0

package/dist/gen/common/v1/pagination_pb.d.ts

@@ -0,0 +1,99 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file common/v1/pagination.proto.
+ */
+export declare const file_common_v1_pagination: GenFile;
+/**
+ * CursorPageRequest is the standard pagination block for List endpoints
+ * backed by keyset pagination. Efficient at any depth on large datasets;
+ * does not support page skipping or totals.
+ *
+ * @generated from message common.v1.CursorPageRequest
+ */
+export type CursorPageRequest = Message<"common.v1.CursorPageRequest"> & {
+    /**
+     * Maximum number of items to return. The server may return fewer; if
+     * zero, a server-chosen default is used.
+     *
+     * @generated from field: int32 page_size = 1;
+     */
+    pageSize: number;
+    /**
+     * Opaque token from a previous response. If empty, the first page is
+     * returned. Tokens are invalid if the sort or filter parameters of the
+     * request changed.
+     *
+     * @generated from field: string page_token = 2;
+     */
+    pageToken: string;
+};
+/**
+ * Describes the message common.v1.CursorPageRequest.
+ * Use `create(CursorPageRequestSchema)` to create a new message.
+ */
+export declare const CursorPageRequestSchema: GenMessage<CursorPageRequest>;
+/**
+ * CursorPageResponse pairs with CursorPageRequest.
+ *
+ * @generated from message common.v1.CursorPageResponse
+ */
+export type CursorPageResponse = Message<"common.v1.CursorPageResponse"> & {
+    /**
+     * Token for retrieving the next page; empty if there are no more
+     * results.
+     *
+     * @generated from field: string next_page_token = 1;
+     */
+    nextPageToken: string;
+};
+/**
+ * Describes the message common.v1.CursorPageResponse.
+ * Use `create(CursorPageResponseSchema)` to create a new message.
+ */
+export declare const CursorPageResponseSchema: GenMessage<CursorPageResponse>;
+/**
+ * OffsetPageRequest is the standard pagination block for List endpoints
+ * backed by offset pagination. Supports page skipping and totals; query
+ * cost grows with page depth, so reserve for moderate datasets.
+ *
+ * @generated from message common.v1.OffsetPageRequest
+ */
+export type OffsetPageRequest = Message<"common.v1.OffsetPageRequest"> & {
+    /**
+     * Maximum number of items to return. The server may return fewer; if
+     * zero, a server-chosen default is used.
+     *
+     * @generated from field: int32 page_size = 1;
+     */
+    pageSize: number;
+    /**
+     * 1-based page number; 0 is treated as page 1.
+     *
+     * @generated from field: int32 page = 2;
+     */
+    page: number;
+};
+/**
+ * Describes the message common.v1.OffsetPageRequest.
+ * Use `create(OffsetPageRequestSchema)` to create a new message.
+ */
+export declare const OffsetPageRequestSchema: GenMessage<OffsetPageRequest>;
+/**
+ * OffsetPageResponse pairs with OffsetPageRequest.
+ *
+ * @generated from message common.v1.OffsetPageResponse
+ */
+export type OffsetPageResponse = Message<"common.v1.OffsetPageResponse"> & {
+    /**
+     * Total number of matching items across all pages.
+     *
+     * @generated from field: int64 total_size = 1;
+     */
+    totalSize: bigint;
+};
+/**
+ * Describes the message common.v1.OffsetPageResponse.
+ * Use `create(OffsetPageResponseSchema)` to create a new message.
+ */
+export declare const OffsetPageResponseSchema: GenMessage<OffsetPageResponse>;

package/dist/gen/common/v1/pagination_pb.js

@@ -0,0 +1,28 @@
+// @generated by protoc-gen-es v2.12.1 with parameter "target=ts"
+// @generated from file common/v1/pagination.proto (package common.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Describes the file common/v1/pagination.proto.
+ */
+export const file_common_v1_pagination = /*@__PURE__*/ fileDesc("Chpjb21tb24vdjEvcGFnaW5hdGlvbi5wcm90bxIJY29tbW9uLnYxIjoKEUN1cnNvclBhZ2VSZXF1ZXN0EhEKCXBhZ2Vfc2l6ZRgBIAEoBRISCgpwYWdlX3Rva2VuGAIgASgJIi0KEkN1cnNvclBhZ2VSZXNwb25zZRIXCg9uZXh0X3BhZ2VfdG9rZW4YASABKAkiNAoRT2Zmc2V0UGFnZVJlcXVlc3QSEQoJcGFnZV9zaXplGAEgASgFEgwKBHBhZ2UYAiABKAUiKAoST2Zmc2V0UGFnZVJlc3BvbnNlEhIKCnRvdGFsX3NpemUYASABKANiBnByb3RvMw");
+/**
+ * Describes the message common.v1.CursorPageRequest.
+ * Use `create(CursorPageRequestSchema)` to create a new message.
+ */
+export const CursorPageRequestSchema = /*@__PURE__*/ messageDesc(file_common_v1_pagination, 0);
+/**
+ * Describes the message common.v1.CursorPageResponse.
+ * Use `create(CursorPageResponseSchema)` to create a new message.
+ */
+export const CursorPageResponseSchema = /*@__PURE__*/ messageDesc(file_common_v1_pagination, 1);
+/**
+ * Describes the message common.v1.OffsetPageRequest.
+ * Use `create(OffsetPageRequestSchema)` to create a new message.
+ */
+export const OffsetPageRequestSchema = /*@__PURE__*/ messageDesc(file_common_v1_pagination, 2);
+/**
+ * Describes the message common.v1.OffsetPageResponse.
+ * Use `create(OffsetPageResponseSchema)` to create a new message.
+ */
+export const OffsetPageResponseSchema = /*@__PURE__*/ messageDesc(file_common_v1_pagination, 3);

package/dist/gen/directory/v1/directory_pb.d.ts

@@ -0,0 +1,57 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file directory/v1/directory.proto.
+ */
+export declare const file_directory_v1_directory: GenFile;
+/**
+ * @generated from message directory.v1.SayHelloRequest
+ */
+export type SayHelloRequest = Message<"directory.v1.SayHelloRequest"> & {
+    /**
+     * The name to greet.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+};
+/**
+ * Describes the message directory.v1.SayHelloRequest.
+ * Use `create(SayHelloRequestSchema)` to create a new message.
+ */
+export declare const SayHelloRequestSchema: GenMessage<SayHelloRequest>;
+/**
+ * @generated from message directory.v1.SayHelloResponse
+ */
+export type SayHelloResponse = Message<"directory.v1.SayHelloResponse"> & {
+    /**
+     * The greeting, e.g. "Hello, Ada!".
+     *
+     * @generated from field: string message = 1;
+     */
+    message: string;
+};
+/**
+ * Describes the message directory.v1.SayHelloResponse.
+ * Use `create(SayHelloResponseSchema)` to create a new message.
+ */
+export declare const SayHelloResponseSchema: GenMessage<SayHelloResponse>;
+/**
+ * DirectoryService is the directory of tinkerer.space.
+ *
+ * Currently exposes a sample endpoint while the service takes shape.
+ *
+ * @generated from service directory.v1.DirectoryService
+ */
+export declare const DirectoryService: GenService<{
+    /**
+     * SayHello returns a greeting for the given name.
+     *
+     * @generated from rpc directory.v1.DirectoryService.SayHello
+     */
+    sayHello: {
+        methodKind: "unary";
+        input: typeof SayHelloRequestSchema;
+        output: typeof SayHelloResponseSchema;
+    };
+}>;

package/dist/gen/directory/v1/directory_pb.js

@@ -0,0 +1,26 @@
+// @generated by protoc-gen-es v2.12.1 with parameter "target=ts"
+// @generated from file directory/v1/directory.proto (package directory.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Describes the file directory/v1/directory.proto.
+ */
+export const file_directory_v1_directory = /*@__PURE__*/ fileDesc("ChxkaXJlY3RvcnkvdjEvZGlyZWN0b3J5LnByb3RvEgxkaXJlY3RvcnkudjEiHwoPU2F5SGVsbG9SZXF1ZXN0EgwKBG5hbWUYASABKAkiIwoQU2F5SGVsbG9SZXNwb25zZRIPCgdtZXNzYWdlGAEgASgJMl0KEERpcmVjdG9yeVNlcnZpY2USSQoIU2F5SGVsbG8SHS5kaXJlY3RvcnkudjEuU2F5SGVsbG9SZXF1ZXN0Gh4uZGlyZWN0b3J5LnYxLlNheUhlbGxvUmVzcG9uc2ViBnByb3RvMw");
+/**
+ * Describes the message directory.v1.SayHelloRequest.
+ * Use `create(SayHelloRequestSchema)` to create a new message.
+ */
+export const SayHelloRequestSchema = /*@__PURE__*/ messageDesc(file_directory_v1_directory, 0);
+/**
+ * Describes the message directory.v1.SayHelloResponse.
+ * Use `create(SayHelloResponseSchema)` to create a new message.
+ */
+export const SayHelloResponseSchema = /*@__PURE__*/ messageDesc(file_directory_v1_directory, 1);
+/**
+ * DirectoryService is the directory of tinkerer.space.
+ *
+ * Currently exposes a sample endpoint while the service takes shape.
+ *
+ * @generated from service directory.v1.DirectoryService
+ */
+export const DirectoryService = /*@__PURE__*/ serviceDesc(file_directory_v1_directory, 0);

package/dist/gen/google/type/date_pb.d.ts

@@ -0,0 +1,55 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file google/type/date.proto.
+ */
+export declare const file_google_type_date: GenFile;
+/**
+ * Represents a whole or partial calendar date, such as a birthday. The time of
+ * day and time zone are either specified elsewhere or are insignificant. The
+ * date is relative to the Gregorian Calendar. This can represent one of the
+ * following:
+ *
+ * * A full date, with non-zero year, month, and day values.
+ * * A month and day, with a zero year (for example, an anniversary).
+ * * A year on its own, with a zero month and a zero day.
+ * * A year and month, with a zero day (for example, a credit card expiration
+ *   date).
+ *
+ * Related types:
+ *
+ * * [google.type.TimeOfDay][google.type.TimeOfDay]
+ * * [google.type.DateTime][google.type.DateTime]
+ * * [google.protobuf.Timestamp][google.protobuf.Timestamp]
+ *
+ * @generated from message google.type.Date
+ */
+export type Date = Message<"google.type.Date"> & {
+    /**
+     * Year of the date. Must be from 1 to 9999, or 0 to specify a date without
+     * a year.
+     *
+     * @generated from field: int32 year = 1;
+     */
+    year: number;
+    /**
+     * Month of a year. Must be from 1 to 12, or 0 to specify a year without a
+     * month and day.
+     *
+     * @generated from field: int32 month = 2;
+     */
+    month: number;
+    /**
+     * Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
+     * to specify a year by itself or a year and month where the day isn't
+     * significant.
+     *
+     * @generated from field: int32 day = 3;
+     */
+    day: number;
+};
+/**
+ * Describes the message google.type.Date.
+ * Use `create(DateSchema)` to create a new message.
+ */
+export declare const DateSchema: GenMessage<Date>;

package/dist/gen/google/type/date_pb.js

@@ -0,0 +1,23 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Describes the file google/type/date.proto.
+ */
+export const file_google_type_date = /*@__PURE__*/ fileDesc("ChZnb29nbGUvdHlwZS9kYXRlLnByb3RvEgtnb29nbGUudHlwZSIwCgREYXRlEgwKBHllYXIYASABKAUSDQoFbW9udGgYAiABKAUSCwoDZGF5GAMgASgFQloKD2NvbS5nb29nbGUudHlwZUIJRGF0ZVByb3RvUAFaNGdvb2dsZS5nb2xhbmcub3JnL2dlbnByb3RvL2dvb2dsZWFwaXMvdHlwZS9kYXRlO2RhdGWiAgNHVFBiBnByb3RvMw");
+/**
+ * Describes the message google.type.Date.
+ * Use `create(DateSchema)` to create a new message.
+ */
+export const DateSchema = /*@__PURE__*/ messageDesc(file_google_type_date, 0);

package/dist/gen/lms/v1/lms_pb.d.ts

@@ -0,0 +1,434 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { CursorPageRequest, CursorPageResponse } from "../../common/v1/pagination_pb";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Date } from "../../google/type/date_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file lms/v1/lms.proto.
+ */
+export declare const file_lms_v1_lms: GenFile;
+/**
+ * GrammarPoint is a grammar point found in a passage, explained in both
+ * Japanese and English.
+ *
+ * @generated from message lms.v1.GrammarPoint
+ */
+export type GrammarPoint = Message<"lms.v1.GrammarPoint"> & {
+    /**
+     * The grammar point explained in Japanese.
+     *
+     * @generated from field: string ja = 1;
+     */
+    ja: string;
+    /**
+     * The grammar point explained in English.
+     *
+     * @generated from field: string en = 2;
+     */
+    en: string;
+};
+/**
+ * Describes the message lms.v1.GrammarPoint.
+ * Use `create(GrammarPointSchema)` to create a new message.
+ */
+export declare const GrammarPointSchema: GenMessage<GrammarPoint>;
+/**
+ * JapaneseWriting is a daily Japanese writing passage together with its
+ * English translation, grammar notes, and assessed difficulty levels.
+ *
+ * @generated from message lms.v1.JapaneseWriting
+ */
+export type JapaneseWriting = Message<"lms.v1.JapaneseWriting"> & {
+    /**
+     * Server-assigned unique identifier.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * The civil date the entry belongs to.
+     *
+     * @generated from field: google.type.Date date = 2;
+     */
+    date?: Date | undefined;
+    /**
+     * Title of the passage in Japanese.
+     *
+     * @generated from field: string title = 3;
+     */
+    title: string;
+    /**
+     * Title of the passage translated to English.
+     *
+     * @generated from field: string title_en = 4;
+     */
+    titleEn: string;
+    /**
+     * The passage text in Japanese.
+     *
+     * @generated from field: string passage = 5;
+     */
+    passage: string;
+    /**
+     * The passage translated to English.
+     *
+     * @generated from field: string passage_en = 6;
+     */
+    passageEn: string;
+    /**
+     * Grammar points about the passage.
+     *
+     * @generated from field: repeated lms.v1.GrammarPoint grammar_points = 7;
+     */
+    grammarPoints: GrammarPoint[];
+    /**
+     * Assessed JLPT level of the passage.
+     *
+     * @generated from field: lms.v1.Jlpt jlpt = 8;
+     */
+    jlpt: Jlpt;
+    /**
+     * Assessed Japanese school grade level of the passage.
+     *
+     * @generated from field: lms.v1.Grade grade = 9;
+     */
+    grade: Grade;
+    /**
+     * When the entry was created.
+     *
+     * @generated from field: google.protobuf.Timestamp created_at = 10;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * When the entry was last updated.
+     *
+     * @generated from field: google.protobuf.Timestamp updated_at = 11;
+     */
+    updatedAt?: Timestamp | undefined;
+    /**
+     * User id of the requester whose request created the entry;
+     * "anonymous" for unauthenticated requests.
+     *
+     * @generated from field: string created_by = 12;
+     */
+    createdBy: string;
+    /**
+     * Model that generated the passage (e.g. an OpenRouter model slug).
+     *
+     * @generated from field: string model = 13;
+     */
+    model: string;
+    /**
+     * Version of the managed prompt the passage was generated with.
+     *
+     * @generated from field: int32 prompt_version = 14;
+     */
+    promptVersion: number;
+};
+/**
+ * Describes the message lms.v1.JapaneseWriting.
+ * Use `create(JapaneseWritingSchema)` to create a new message.
+ */
+export declare const JapaneseWritingSchema: GenMessage<JapaneseWriting>;
+/**
+ * @generated from message lms.v1.GetDailyJapaneseWritingRequest
+ */
+export type GetDailyJapaneseWritingRequest = Message<"lms.v1.GetDailyJapaneseWritingRequest"> & {
+    /**
+     * The target difficulty level. Exactly one must be set.
+     *
+     * @generated from oneof lms.v1.GetDailyJapaneseWritingRequest.level
+     */
+    level: {
+        /**
+         * Target JLPT level.
+         *
+         * @generated from field: lms.v1.Jlpt jlpt = 1;
+         */
+        value: Jlpt;
+        case: "jlpt";
+    } | {
+        /**
+         * Target Japanese school grade level.
+         *
+         * @generated from field: lms.v1.Grade grade = 2;
+         */
+        value: Grade;
+        case: "grade";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message lms.v1.GetDailyJapaneseWritingRequest.
+ * Use `create(GetDailyJapaneseWritingRequestSchema)` to create a new message.
+ */
+export declare const GetDailyJapaneseWritingRequestSchema: GenMessage<GetDailyJapaneseWritingRequest>;
+/**
+ * @generated from message lms.v1.GetDailyJapaneseWritingResponse
+ */
+export type GetDailyJapaneseWritingResponse = Message<"lms.v1.GetDailyJapaneseWritingResponse"> & {
+    /**
+     * Today's writing for the requested level.
+     *
+     * @generated from field: lms.v1.JapaneseWriting writing = 1;
+     */
+    writing?: JapaneseWriting | undefined;
+};
+/**
+ * Describes the message lms.v1.GetDailyJapaneseWritingResponse.
+ * Use `create(GetDailyJapaneseWritingResponseSchema)` to create a new message.
+ */
+export declare const GetDailyJapaneseWritingResponseSchema: GenMessage<GetDailyJapaneseWritingResponse>;
+/**
+ * @generated from message lms.v1.ListJapaneseWritingsRequest
+ */
+export type ListJapaneseWritingsRequest = Message<"lms.v1.ListJapaneseWritingsRequest"> & {
+    /**
+     * Filter by difficulty level. If unset, writings of all levels are
+     * returned.
+     *
+     * @generated from oneof lms.v1.ListJapaneseWritingsRequest.level
+     */
+    level: {
+        /**
+         * Only return writings assessed at this JLPT level.
+         *
+         * @generated from field: lms.v1.Jlpt jlpt = 1;
+         */
+        value: Jlpt;
+        case: "jlpt";
+    } | {
+        /**
+         * Only return writings assessed at this school grade level.
+         *
+         * @generated from field: lms.v1.Grade grade = 2;
+         */
+        value: Grade;
+        case: "grade";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * Only return writings dated on or after this date (inclusive).
+     * Optional.
+     *
+     * @generated from field: google.type.Date start_date = 3;
+     */
+    startDate?: Date | undefined;
+    /**
+     * Only return writings dated on or before this date (inclusive).
+     * Optional.
+     *
+     * @generated from field: google.type.Date end_date = 4;
+     */
+    endDate?: Date | undefined;
+    /**
+     * Cursor pagination parameters.
+     *
+     * @generated from field: common.v1.CursorPageRequest pagination = 5;
+     */
+    pagination?: CursorPageRequest | undefined;
+};
+/**
+ * Describes the message lms.v1.ListJapaneseWritingsRequest.
+ * Use `create(ListJapaneseWritingsRequestSchema)` to create a new message.
+ */
+export declare const ListJapaneseWritingsRequestSchema: GenMessage<ListJapaneseWritingsRequest>;
+/**
+ * @generated from message lms.v1.ListJapaneseWritingsResponse
+ */
+export type ListJapaneseWritingsResponse = Message<"lms.v1.ListJapaneseWritingsResponse"> & {
+    /**
+     * The writings matching the request, ordered by date descending.
+     *
+     * @generated from field: repeated lms.v1.JapaneseWriting writings = 1;
+     */
+    writings: JapaneseWriting[];
+    /**
+     * Cursor pagination metadata.
+     *
+     * @generated from field: common.v1.CursorPageResponse pagination = 2;
+     */
+    pagination?: CursorPageResponse | undefined;
+};
+/**
+ * Describes the message lms.v1.ListJapaneseWritingsResponse.
+ * Use `create(ListJapaneseWritingsResponseSchema)` to create a new message.
+ */
+export declare const ListJapaneseWritingsResponseSchema: GenMessage<ListJapaneseWritingsResponse>;
+/**
+ * Jlpt is a JLPT (Japanese-Language Proficiency Test) level, from N5
+ * (beginner) to N1 (advanced).
+ *
+ * @generated from enum lms.v1.Jlpt
+ */
+export declare enum Jlpt {
+    /**
+     * Unknown or not set.
+     *
+     * @generated from enum value: JLPT_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * N5: beginner.
+     *
+     * @generated from enum value: JLPT_N5 = 1;
+     */
+    N5 = 1,
+    /**
+     * N4: elementary.
+     *
+     * @generated from enum value: JLPT_N4 = 2;
+     */
+    N4 = 2,
+    /**
+     * N3: intermediate.
+     *
+     * @generated from enum value: JLPT_N3 = 3;
+     */
+    N3 = 3,
+    /**
+     * N2: upper intermediate.
+     *
+     * @generated from enum value: JLPT_N2 = 4;
+     */
+    N2 = 4,
+    /**
+     * N1: advanced.
+     *
+     * @generated from enum value: JLPT_N1 = 5;
+     */
+    N1 = 5
+}
+/**
+ * Describes the enum lms.v1.Jlpt.
+ */
+export declare const JlptSchema: GenEnum<Jlpt>;
+/**
+ * Grade is a Japanese school grade level, from first year of elementary
+ * school (小1) to third year of high school (高3).
+ *
+ * @generated from enum lms.v1.Grade
+ */
+export declare enum Grade {
+    /**
+     * Unknown or not set.
+     *
+     * @generated from enum value: GRADE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * 小1: elementary school, year 1.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_1 = 1;
+     */
+    ELEMENTARY_1 = 1,
+    /**
+     * 小2: elementary school, year 2.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_2 = 2;
+     */
+    ELEMENTARY_2 = 2,
+    /**
+     * 小3: elementary school, year 3.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_3 = 3;
+     */
+    ELEMENTARY_3 = 3,
+    /**
+     * 小4: elementary school, year 4.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_4 = 4;
+     */
+    ELEMENTARY_4 = 4,
+    /**
+     * 小5: elementary school, year 5.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_5 = 5;
+     */
+    ELEMENTARY_5 = 5,
+    /**
+     * 小6: elementary school, year 6.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_6 = 6;
+     */
+    ELEMENTARY_6 = 6,
+    /**
+     * 中1: junior high school, year 1.
+     *
+     * @generated from enum value: GRADE_JUNIOR_HIGH_1 = 7;
+     */
+    JUNIOR_HIGH_1 = 7,
+    /**
+     * 中2: junior high school, year 2.
+     *
+     * @generated from enum value: GRADE_JUNIOR_HIGH_2 = 8;
+     */
+    JUNIOR_HIGH_2 = 8,
+    /**
+     * 中3: junior high school, year 3.
+     *
+     * @generated from enum value: GRADE_JUNIOR_HIGH_3 = 9;
+     */
+    JUNIOR_HIGH_3 = 9,
+    /**
+     * 高1: high school, year 1.
+     *
+     * @generated from enum value: GRADE_HIGH_1 = 10;
+     */
+    HIGH_1 = 10,
+    /**
+     * 高2: high school, year 2.
+     *
+     * @generated from enum value: GRADE_HIGH_2 = 11;
+     */
+    HIGH_2 = 11,
+    /**
+     * 高3: high school, year 3.
+     *
+     * @generated from enum value: GRADE_HIGH_3 = 12;
+     */
+    HIGH_3 = 12
+}
+/**
+ * Describes the enum lms.v1.Grade.
+ */
+export declare const GradeSchema: GenEnum<Grade>;
+/**
+ * LmsService provides language-learning content for tinkerer.space.
+ *
+ * Currently focused on daily Japanese writing practice: short passages
+ * tailored to a JLPT proficiency level or a Japanese school grade level.
+ *
+ * @generated from service lms.v1.LmsService
+ */
+export declare const LmsService: GenService<{
+    /**
+     * GetDailyJapaneseWriting returns today's Japanese writing for the given
+     * level. If no entry exists for the current date yet, one is generated,
+     * persisted, and returned; subsequent calls for the same date and level
+     * return the stored entry.
+     *
+     * @generated from rpc lms.v1.LmsService.GetDailyJapaneseWriting
+     */
+    getDailyJapaneseWriting: {
+        methodKind: "unary";
+        input: typeof GetDailyJapaneseWritingRequestSchema;
+        output: typeof GetDailyJapaneseWritingResponseSchema;
+    };
+    /**
+     * ListJapaneseWritings lists previously generated Japanese writings,
+     * filterable by date range and level. Missing entries are never
+     * generated by this method.
+     *
+     * @generated from rpc lms.v1.LmsService.ListJapaneseWritings
+     */
+    listJapaneseWritings: {
+        methodKind: "unary";
+        input: typeof ListJapaneseWritingsRequestSchema;
+        output: typeof ListJapaneseWritingsResponseSchema;
+    };
+}>;

package/dist/gen/lms/v1/lms_pb.js

@@ -0,0 +1,190 @@
+// @generated by protoc-gen-es v2.12.1 with parameter "target=ts"
+// @generated from file lms/v1/lms.proto (package lms.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_common_v1_pagination } from "../../common/v1/pagination_pb";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+import { file_google_type_date } from "../../google/type/date_pb";
+/**
+ * Describes the file lms/v1/lms.proto.
+ */
+export const file_lms_v1_lms = /*@__PURE__*/ fileDesc("ChBsbXMvdjEvbG1zLnByb3RvEgZsbXMudjEiJgoMR3JhbW1hclBvaW50EgoKAmphGAEgASgJEgoKAmVuGAIgASgJIocDCg9KYXBhbmVzZVdyaXRpbmcSCgoCaWQYASABKAkSHwoEZGF0ZRgCIAEoCzIRLmdvb2dsZS50eXBlLkRhdGUSDQoFdGl0bGUYAyABKAkSEAoIdGl0bGVfZW4YBCABKAkSDwoHcGFzc2FnZRgFIAEoCRISCgpwYXNzYWdlX2VuGAYgASgJEiwKDmdyYW1tYXJfcG9pbnRzGAcgAygLMhQubG1zLnYxLkdyYW1tYXJQb2ludBIaCgRqbHB0GAggASgOMgwubG1zLnYxLkpscHQSHAoFZ3JhZGUYCSABKA4yDS5sbXMudjEuR3JhZGUSLgoKY3JlYXRlZF9hdBgKIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLgoKdXBkYXRlZF9hdBgLIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASEgoKY3JlYXRlZF9ieRgMIAEoCRINCgVtb2RlbBgNIAEoCRIWCg5wcm9tcHRfdmVyc2lvbhgOIAEoBSJnCh5HZXREYWlseUphcGFuZXNlV3JpdGluZ1JlcXVlc3QSHAoEamxwdBgBIAEoDjIMLmxtcy52MS5KbHB0SAASHgoFZ3JhZGUYAiABKA4yDS5sbXMudjEuR3JhZGVIAEIHCgVsZXZlbCJLCh9HZXREYWlseUphcGFuZXNlV3JpdGluZ1Jlc3BvbnNlEigKB3dyaXRpbmcYASABKAsyFy5sbXMudjEuSmFwYW5lc2VXcml0aW5nIuIBChtMaXN0SmFwYW5lc2VXcml0aW5nc1JlcXVlc3QSHAoEamxwdBgBIAEoDjIMLmxtcy52MS5KbHB0SAASHgoFZ3JhZGUYAiABKA4yDS5sbXMudjEuR3JhZGVIABIlCgpzdGFydF9kYXRlGAMgASgLMhEuZ29vZ2xlLnR5cGUuRGF0ZRIjCghlbmRfZGF0ZRgEIAEoCzIRLmdvb2dsZS50eXBlLkRhdGUSMAoKcGFnaW5hdGlvbhgFIAEoCzIcLmNvbW1vbi52MS5DdXJzb3JQYWdlUmVxdWVzdEIHCgVsZXZlbCJ8ChxMaXN0SmFwYW5lc2VXcml0aW5nc1Jlc3BvbnNlEikKCHdyaXRpbmdzGAEgAygLMhcubG1zLnYxLkphcGFuZXNlV3JpdGluZxIxCgpwYWdpbmF0aW9uGAIgASgLMh0uY29tbW9uLnYxLkN1cnNvclBhZ2VSZXNwb25zZSpdCgRKbHB0EhQKEEpMUFRfVU5TUEVDSUZJRUQQABILCgdKTFBUX041EAESCwoHSkxQVF9ONBACEgsKB0pMUFRfTjMQAxILCgdKTFBUX04yEAQSCwoHSkxQVF9OMRAFKq8CCgVHcmFkZRIVChFHUkFERV9VTlNQRUNJRklFRBAAEhYKEkdSQURFX0VMRU1FTlRBUllfMRABEhYKEkdSQURFX0VMRU1FTlRBUllfMhACEhYKEkdSQURFX0VMRU1FTlRBUllfMxADEhYKEkdSQURFX0VMRU1FTlRBUllfNBAEEhYKEkdSQURFX0VMRU1FTlRBUllfNRAFEhYKEkdSQURFX0VMRU1FTlRBUllfNhAGEhcKE0dSQURFX0pVTklPUl9ISUdIXzEQBxIXChNHUkFERV9KVU5JT1JfSElHSF8yEAgSFwoTR1JBREVfSlVOSU9SX0hJR0hfMxAJEhAKDEdSQURFX0hJR0hfMRAKEhAKDEdSQURFX0hJR0hfMhALEhAKDEdSQURFX0hJR0hfMxAMMtsBCgpMbXNTZXJ2aWNlEmoKF0dldERhaWx5SmFwYW5lc2VXcml0aW5nEiYubG1zLnYxLkdldERhaWx5SmFwYW5lc2VXcml0aW5nUmVxdWVzdBonLmxtcy52MS5HZXREYWlseUphcGFuZXNlV3JpdGluZ1Jlc3BvbnNlEmEKFExpc3RKYXBhbmVzZVdyaXRpbmdzEiMubG1zLnYxLkxpc3RKYXBhbmVzZVdyaXRpbmdzUmVxdWVzdBokLmxtcy52MS5MaXN0SmFwYW5lc2VXcml0aW5nc1Jlc3BvbnNlYgZwcm90bzM", [file_common_v1_pagination, file_google_protobuf_timestamp, file_google_type_date]);
+/**
+ * Describes the message lms.v1.GrammarPoint.
+ * Use `create(GrammarPointSchema)` to create a new message.
+ */
+export const GrammarPointSchema = /*@__PURE__*/ messageDesc(file_lms_v1_lms, 0);
+/**
+ * Describes the message lms.v1.JapaneseWriting.
+ * Use `create(JapaneseWritingSchema)` to create a new message.
+ */
+export const JapaneseWritingSchema = /*@__PURE__*/ messageDesc(file_lms_v1_lms, 1);
+/**
+ * Describes the message lms.v1.GetDailyJapaneseWritingRequest.
+ * Use `create(GetDailyJapaneseWritingRequestSchema)` to create a new message.
+ */
+export const GetDailyJapaneseWritingRequestSchema = /*@__PURE__*/ messageDesc(file_lms_v1_lms, 2);
+/**
+ * Describes the message lms.v1.GetDailyJapaneseWritingResponse.
+ * Use `create(GetDailyJapaneseWritingResponseSchema)` to create a new message.
+ */
+export const GetDailyJapaneseWritingResponseSchema = /*@__PURE__*/ messageDesc(file_lms_v1_lms, 3);
+/**
+ * Describes the message lms.v1.ListJapaneseWritingsRequest.
+ * Use `create(ListJapaneseWritingsRequestSchema)` to create a new message.
+ */
+export const ListJapaneseWritingsRequestSchema = /*@__PURE__*/ messageDesc(file_lms_v1_lms, 4);
+/**
+ * Describes the message lms.v1.ListJapaneseWritingsResponse.
+ * Use `create(ListJapaneseWritingsResponseSchema)` to create a new message.
+ */
+export const ListJapaneseWritingsResponseSchema = /*@__PURE__*/ messageDesc(file_lms_v1_lms, 5);
+/**
+ * Jlpt is a JLPT (Japanese-Language Proficiency Test) level, from N5
+ * (beginner) to N1 (advanced).
+ *
+ * @generated from enum lms.v1.Jlpt
+ */
+export var Jlpt;
+(function (Jlpt) {
+    /**
+     * Unknown or not set.
+     *
+     * @generated from enum value: JLPT_UNSPECIFIED = 0;
+     */
+    Jlpt[Jlpt["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * N5: beginner.
+     *
+     * @generated from enum value: JLPT_N5 = 1;
+     */
+    Jlpt[Jlpt["N5"] = 1] = "N5";
+    /**
+     * N4: elementary.
+     *
+     * @generated from enum value: JLPT_N4 = 2;
+     */
+    Jlpt[Jlpt["N4"] = 2] = "N4";
+    /**
+     * N3: intermediate.
+     *
+     * @generated from enum value: JLPT_N3 = 3;
+     */
+    Jlpt[Jlpt["N3"] = 3] = "N3";
+    /**
+     * N2: upper intermediate.
+     *
+     * @generated from enum value: JLPT_N2 = 4;
+     */
+    Jlpt[Jlpt["N2"] = 4] = "N2";
+    /**
+     * N1: advanced.
+     *
+     * @generated from enum value: JLPT_N1 = 5;
+     */
+    Jlpt[Jlpt["N1"] = 5] = "N1";
+})(Jlpt || (Jlpt = {}));
+/**
+ * Describes the enum lms.v1.Jlpt.
+ */
+export const JlptSchema = /*@__PURE__*/ enumDesc(file_lms_v1_lms, 0);
+/**
+ * Grade is a Japanese school grade level, from first year of elementary
+ * school (小1) to third year of high school (高3).
+ *
+ * @generated from enum lms.v1.Grade
+ */
+export var Grade;
+(function (Grade) {
+    /**
+     * Unknown or not set.
+     *
+     * @generated from enum value: GRADE_UNSPECIFIED = 0;
+     */
+    Grade[Grade["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * 小1: elementary school, year 1.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_1 = 1;
+     */
+    Grade[Grade["ELEMENTARY_1"] = 1] = "ELEMENTARY_1";
+    /**
+     * 小2: elementary school, year 2.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_2 = 2;
+     */
+    Grade[Grade["ELEMENTARY_2"] = 2] = "ELEMENTARY_2";
+    /**
+     * 小3: elementary school, year 3.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_3 = 3;
+     */
+    Grade[Grade["ELEMENTARY_3"] = 3] = "ELEMENTARY_3";
+    /**
+     * 小4: elementary school, year 4.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_4 = 4;
+     */
+    Grade[Grade["ELEMENTARY_4"] = 4] = "ELEMENTARY_4";
+    /**
+     * 小5: elementary school, year 5.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_5 = 5;
+     */
+    Grade[Grade["ELEMENTARY_5"] = 5] = "ELEMENTARY_5";
+    /**
+     * 小6: elementary school, year 6.
+     *
+     * @generated from enum value: GRADE_ELEMENTARY_6 = 6;
+     */
+    Grade[Grade["ELEMENTARY_6"] = 6] = "ELEMENTARY_6";
+    /**
+     * 中1: junior high school, year 1.
+     *
+     * @generated from enum value: GRADE_JUNIOR_HIGH_1 = 7;
+     */
+    Grade[Grade["JUNIOR_HIGH_1"] = 7] = "JUNIOR_HIGH_1";
+    /**
+     * 中2: junior high school, year 2.
+     *
+     * @generated from enum value: GRADE_JUNIOR_HIGH_2 = 8;
+     */
+    Grade[Grade["JUNIOR_HIGH_2"] = 8] = "JUNIOR_HIGH_2";
+    /**
+     * 中3: junior high school, year 3.
+     *
+     * @generated from enum value: GRADE_JUNIOR_HIGH_3 = 9;
+     */
+    Grade[Grade["JUNIOR_HIGH_3"] = 9] = "JUNIOR_HIGH_3";
+    /**
+     * 高1: high school, year 1.
+     *
+     * @generated from enum value: GRADE_HIGH_1 = 10;
+     */
+    Grade[Grade["HIGH_1"] = 10] = "HIGH_1";
+    /**
+     * 高2: high school, year 2.
+     *
+     * @generated from enum value: GRADE_HIGH_2 = 11;
+     */
+    Grade[Grade["HIGH_2"] = 11] = "HIGH_2";
+    /**
+     * 高3: high school, year 3.
+     *
+     * @generated from enum value: GRADE_HIGH_3 = 12;
+     */
+    Grade[Grade["HIGH_3"] = 12] = "HIGH_3";
+})(Grade || (Grade = {}));
+/**
+ * Describes the enum lms.v1.Grade.
+ */
+export const GradeSchema = /*@__PURE__*/ enumDesc(file_lms_v1_lms, 1);
+/**
+ * LmsService provides language-learning content for tinkerer.space.
+ *
+ * Currently focused on daily Japanese writing practice: short passages
+ * tailored to a JLPT proficiency level or a Japanese school grade level.
+ *
+ * @generated from service lms.v1.LmsService
+ */
+export const LmsService = /*@__PURE__*/ serviceDesc(file_lms_v1_lms, 0);

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @tinkerer/sdk — browser SDK for tinkerer.space services.
+ *
+ * Clients speak gRPC-web to the Envoy gateway, which translates to native
+ * gRPC for the backend services.
+ */
+import { type Client } from "@connectrpc/connect";
+import { DirectoryService } from "./gen/directory/v1/directory_pb.js";
+import { LmsService } from "./gen/lms/v1/lms_pb.js";
+export type { SayHelloRequest, SayHelloResponse, } from "./gen/directory/v1/directory_pb.js";
+export type { Date } from "./gen/google/type/date_pb.js";
+export type { GetDailyJapaneseWritingRequest, GetDailyJapaneseWritingResponse, GrammarPoint, JapaneseWriting, ListJapaneseWritingsRequest, ListJapaneseWritingsResponse, } from "./gen/lms/v1/lms_pb.js";
+export { Grade, Jlpt } from "./gen/lms/v1/lms_pb.js";
+export { DirectoryService, LmsService };
+/** A client for the directory service. */
+export type DirectoryClient = Client<typeof DirectoryService>;
+/**
+ * Creates a directory service client.
+ *
+ * @param baseUrl Base URL of the tinkerer.space API gateway,
+ *   e.g. `https://api.tinkerer.space`.
+ */
+export declare function createDirectoryClient(baseUrl: string): DirectoryClient;
+/** A client for the lms service. */
+export type LmsClient = Client<typeof LmsService>;
+/**
+ * Creates an lms service client.
+ *
+ * @param baseUrl Base URL of the tinkerer.space API gateway,
+ *   e.g. `https://api.tinkerer.space`.
+ */
+export declare function createLmsClient(baseUrl: string): LmsClient;

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @tinkerer/sdk — browser SDK for tinkerer.space services.
+ *
+ * Clients speak gRPC-web to the Envoy gateway, which translates to native
+ * gRPC for the backend services.
+ */
+import { createClient } from "@connectrpc/connect";
+import { createGrpcWebTransport } from "@connectrpc/connect-web";
+import { DirectoryService } from "./gen/directory/v1/directory_pb.js";
+import { LmsService } from "./gen/lms/v1/lms_pb.js";
+export { Grade, Jlpt } from "./gen/lms/v1/lms_pb.js";
+export { DirectoryService, LmsService };
+/**
+ * Creates a directory service client.
+ *
+ * @param baseUrl Base URL of the tinkerer.space API gateway,
+ *   e.g. `https://api.tinkerer.space`.
+ */
+export function createDirectoryClient(baseUrl) {
+    const transport = createGrpcWebTransport({ baseUrl });
+    return createClient(DirectoryService, transport);
+}
+/**
+ * Creates an lms service client.
+ *
+ * @param baseUrl Base URL of the tinkerer.space API gateway,
+ *   e.g. `https://api.tinkerer.space`.
+ */
+export function createLmsClient(baseUrl) {
+    const transport = createGrpcWebTransport({ baseUrl });
+    return createClient(LmsService, transport);
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@tinkerer/sdk",
+  "version": "0.1.0",
+  "description": "Browser SDK for tinkerer.space services.",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bakakaba/tinkr_api.git",
+    "directory": "sdks/web"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prepublishOnly": "bun install --frozen-lockfile && rm -rf dist && bun run build",
+    "build": "tsc",
+    "lint": "biome ci . && tsc --noEmit"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.12.1",
+    "@connectrpc/connect": "^2.1.2",
+    "@connectrpc/connect-web": "^2.1.2"
+  }
+}